Mini Program
取消
Development
中文
EN
取消
  • Guide

    • # Share it on WeChat Moments

    2.11.3

    Supported platforms: Android, , and iOS: WeChat 8.0.24 and above.

    The Weixin Mini Program page can be shared on WeChat Moments.It is suitable for sharing content-type pages, not for sharing pages with more interaction.

    # Set the sharing status

    Weixin Mini Program By default, the page cannot be shared in WeChat Moments; developers need to manually enable the "Share in WeChat Moments" feature.The page can be shared on WeChat Moments under the following two conditions:

    1. First, the page needs to be set to allow "sending to a friend."Specific reference Page.onShareAppMessage interface documentation
    2. After fulfilling condition 1, the page needs to be configured to allow "sharing to WeChat Moments," and it is also possible to customize the title, sharing image, and other elements.Specific reference Page.onShareTimeline interface documentation

    Pages that meet both of the aforementioned conditions can be shared on WeChat Moments.

    # Single Page Mode

    When a user opens the Weixin Mini Program page shared on WeChat Moments, it does not actually open the mini-program but instead navigates to a "mini-program single-page mode" page, which has the following characteristics:

    1. Under "Single Page Mode," the navigation bar is fixed at the top of the page, and the title is displayed as the title of the current page JSON configuration.Fixed at the bottom of the operating bar, click on the operating bar "to Weixin Mini Program" to open the current page of the Mini Program.Neither the top navigation bar nor the bottom action bar support custom styles.
    2. "Single page mode" is the default to run the Weixin Mini Program page content, but because the page is fixed at the top of the navigation bar and the bottom of the operation bar, is likely to affect the layout of the Mini Program page.Therefore, developers are asked to pay special attention to adapting page interactions in "single page mode" to achieve a smooth and complete interactive experience.
    3. In "Single Page Mode," some components or interfaces have certain limitations, as detailed in the Limitations in Single Page Mode section below

    avatar

    # Page alignment

    Page adaptation can be done by determining that the scene value is equal to 1154.In addition, in single page mode, you can set the intersection state of the top navigation bar and the page, specific reference navigationBarFit configuration.

    Also note that in single-page mode, the safeArea returned by the wx.getSystemInfo interface is the entire screen space.

    # Restrictions in single page mode

    Weixin Mini Program "Single page mode" is suitable for pure content display scenarios, and the interaction and interface capabilities that can be achieved are limited, so there are the following limitations:

    1. The page has no login state, and the login related interface, such aswx.loginare not available;Cloud development resources require unlogged access to be used in single-page mode, see Unlogged Mode .
    2. Not allowed to jump to other pages, including any jump to Weixin Mini Program pages, jump to other Mini Programs, jump to WeChat native pages
    3. Horizontal screens are not allowed
    4. If the page contains tabBar, tabBar will not be rendered, including custom tabBar
    5. Local storage is not shared with Weixin Mini Program normal mode

    For some interactive components or interfaces, when called after clicking, a toast prompt "Go to Weixin Mini Program for full service."To achieve a good user experience, be aware of the interface ability to adapt to single page mode, and do not use a lot of disabled interfaces or components.

    List of disabling capabilities:

    classification Functional points
    assembly button open-type 、 camera 、 editor 、 form 、 functional-page-navigator 、 live-pusher 、 navigator 、 navigation-bar 、 official-account 、 open-data 、 web-view
    routing wx.redirectTo 、 wx.reLaunch 、 wx.navigateTo 、 wx.switchTab 、 wx.navigateBack
    interface Navigation Bar , Tab Bar
    network MDNS 、 UDP communication
    Data Cache Periodic Updates
    Media VoIP 、 wx.chooseMedia 、 wx.chooseImage 、 wx.saveImageToPhotosAlbum 、 wx.chooseVideo 、 wx.saveVideoToPhotosAlbum 、 wx.getVideoInfo 、 wx.compressVideo
    position wx.openLocation 、 wx.chooseLocation 、 wx.startLocationUpdateBackground 、 wx.startLocationUpdate
    Forward wx.getShareInfo 、 wx.showShareMenu 、 wx.hideShareMenu 、 wx.updateShareMenu
    file wx.openDocument
    Open interfaces Login , Weixin Mini ProgramJump , User Information , [( Payment , Authorisation 、 Setting ، Shipping address , Card voucher 、 Invoices ، [Biometric authentication]]]((wx.startSoterAuthentication)) 、 WeChat sports 、 [[TAG11-START]] WeChat red envelopes]((wx.showRedPackage))
    equipment [Bluetooth []]]((wx.startBluetoothDevicesDiscovery)) 、 iBeacon 、 Wi-Fi 、 NFC 、 Contacts , Clipboard 、 Phone ، Scan
    Advertising ad 、 wx.createRewardedVideoAd 、 wx.createInterstitialAd

    # Operational Requirements

    The ability to share WeChat Moments is designed to meet the needs of content-centric sharing scenarios; however, its misuse for marketing, inducement, or similar activities will be penalized.

    1. Weixin Mini Program There must be no abusive sharing violations in the services provided.Examples include forced user sharing behavior; Incentive behaviour to share immediate benefits; As well as behaviors to induce sharing purposes through explicit or implied styles.See < Weixin Mini Program Platform Operation Specification
    2. In "Single Page Mode," the user must not be induced or forced to click "Open Weixin Mini Program," should be presented as complete as possible in "Single Page Mode"

    # Note

    1. Low version WeChat When the Guest opens, it will enter an upgrade prompt page
    2. Do not support the Weixin Mini Program page directly initiated sharing
    3. Custom page paths are not supported when customizing shared content
    4. Pages with web-view components do not support initiating shares
    5. Support opening development and experience versions, and the page prompts permissionless people when they enter