From: Editor Lionbridge Date: Mon, 16 Oct 2017 10:54:01 +0000 (+0300) Subject: Update Web Guide content X-Git-Tag: MD/guides-dotnet~79^2 X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=ffa00fd04bea6d751ba869c1c3e506c44236d47b;p=sdk%2Fonline-doc.git Update Web Guide content This is a manual cherry-pick from change #150428 in the tizen_3.0 branch. Change-Id: Id419b0f1d1874942951ac6b8452fc35ecd698344 --- diff --git a/org.tizen.guides/html/web/alarm/alarms_w.htm b/org.tizen.guides/html/web/alarm/alarms_w.htm index b95a60b..87dd5d5 100644 --- a/org.tizen.guides/html/web/alarm/alarms_w.htm +++ b/org.tizen.guides/html/web/alarm/alarms_w.htm @@ -137,7 +137,7 @@ tizen.alarm.remove(alarm1.id);

Launching Applications with Alarms

-

Learning how to launch application with alarms is a basic alarm management skill:

+

Learning how to launch applications with alarms is a basic alarm management skill:

  1. To launch an application when an alarm is triggered, you must define the application as a parameter in the add() method used to add the created alarm to the system:

    diff --git a/org.tizen.guides/html/web/app_management/app_communication_w.htm b/org.tizen.guides/html/web/app_management/app_communication_w.htm
    index 1f4a634..b372db8 100644
    --- a/org.tizen.guides/html/web/app_management/app_communication_w.htm
    +++ b/org.tizen.guides/html/web/app_management/app_communication_w.htm
    @@ -44,7 +44,7 @@
     
     
  2. Data Control -

    You can exchanging SQL- or key-value-type data between applications. All applications (consumers) can request data shared by other applications (providers), and 1 provider can server multiple consumers.

  3. +

    You can exchanging SQL- or key-value-type data between applications. All applications (consumers) can request data shared by other applications (providers), and 1 provider can serve multiple consumers.

  4. diff --git a/org.tizen.guides/html/web/app_management/app_controls_w.htm b/org.tizen.guides/html/web/app_management/app_controls_w.htm index e425ab3..af3c502 100644 --- a/org.tizen.guides/html/web/app_management/app_controls_w.htm +++ b/org.tizen.guides/html/web/app_management/app_controls_w.htm @@ -56,7 +56,7 @@

    Application Controls

    -

    Tizen provides various application management features, including application launching, event handling, and information retrieval.

    +

    You can use various application management features, including application launching, event handling, and information retrieval.

    The Application API is mandatory for both Tizen mobile and wearable profiles, which means that it is supported in all mobile and wearable devices. All mandatory APIs are supported on the Tizen Emulators.

    @@ -324,13 +324,13 @@ function onRunningApplicationContexts(contexts) { tizen.application.getAppsContext(onRunningApplicationContexts);

    The list of application contexts is returned to the given event handler as an array of the ApplicationContext objects.

    -
  5. To retrieve basic application information, use the getAppInfo() method of the ApplicationManager interface.

    Provide the application ID of the application whose information you want as a parameter for the method. If no application ID is set, the method retrieves the information about the application calling the method.

    +
  6. To retrieve basic application information, use the getAppInfo() method of the ApplicationManager interface.

    Provide the application ID of the application whose information you want as a parameter for the method. If no application ID is set, the method uses the details of the application calling the method.

     var appinfo = tizen.application.getAppInfo('org.tizen.application');
     console.log('The application icon path: ' + appinfo.iconPath);
     console.log('The application name: ' + appinfo.name);
     
  7. -
  8. To retrieve application context information, use the getAppContext() method of the ApplicationManager interface.

    Provide the context ID of the application whose context information you want as a parameter for the method. If no context ID is set, the method retrieves the information about the application calling the method.

    +
  9. To retrieve application context information, use the getAppContext() method of the ApplicationManager interface.

    Provide the context ID of the application whose context information you want as a parameter for the method. If no context ID is set, the method uses the details of the application calling the method.

     var appContext = tizen.application.getAppContext();
     console.log('Application context retrieved for app ' + appContext.id);
    diff --git a/org.tizen.guides/html/web/app_management/app_icons_w.htm b/org.tizen.guides/html/web/app_management/app_icons_w.htm
    index 4744db5..183f65d 100644
    --- a/org.tizen.guides/html/web/app_management/app_icons_w.htm
    +++ b/org.tizen.guides/html/web/app_management/app_icons_w.htm
    @@ -106,7 +106,7 @@ function watcher(appId, count) {
     tizen.badge.addChangeListener(['BDb5tZJe47.TestSample'], watcher);
     

    BDb5tZJe47.TestSample is the application ID of the application to monitor. The first argument of the addChangeListener() method is an array of application identifiers. This allows you to bind the listener to several applications at same time.

  10. -
  11. To stop receiving notification about badge changes, use the removeChangeListener () method:

    +
  12. To stop receiving notifications about badge changes, use the removeChangeListener() method:

     tizen.badge.removeChangeListener(['BDb5tZJe47.TestSample']);
     
  13. diff --git a/org.tizen.guides/html/web/app_management/app_management_cover_w.htm b/org.tizen.guides/html/web/app_management/app_management_cover_w.htm index 51f9909..68afb3e 100644 --- a/org.tizen.guides/html/web/app_management/app_management_cover_w.htm +++ b/org.tizen.guides/html/web/app_management/app_management_cover_w.htm @@ -42,7 +42,7 @@

    You can manage applications and get information about them. You can also handle events and enable an application to run in the background.

    -

    Tizen provides various application models to allow you to create applications targeted for specific tasks. You can create UI applications to run on the foreground, and service applications to run in the background. The service application is used to perform tasks which need to run periodically or continuously but do not require user interaction.

    +

    Tizen provides various application models to allow you to create applications targeted for specific tasks. You can create UI applications to run on the foreground, and service applications to run in the background. The service application is used to perform tasks that need to run periodically or continuously, but do not require any user interaction.

  14. Application Groups diff --git a/org.tizen.guides/html/web/app_management/applications_w.htm b/org.tizen.guides/html/web/app_management/applications_w.htm index 871649e..a02ed01 100644 --- a/org.tizen.guides/html/web/app_management/applications_w.htm +++ b/org.tizen.guides/html/web/app_management/applications_w.htm @@ -57,11 +57,11 @@

    The UI application has a graphical user interface. You can create diverse applications with a variety of features, and design versatile applications and intriguing user interfaces with text and graphics while taking advantage of many device functionalities, such as sensors and call operations. In addition, you can, for example, manage content and media files, use network and social services, and provide messaging functionality.

    The UI application is the most common Tizen application model.

  15. Service Application -

    The service application is a Tizen Web application without a graphical user interface that runs in the background. They can be very useful in performing activities (such as getting sensor data in the background) that need to run periodically or continuously, but do not require any user intervention.

  16. +

    The service application is a Tizen Web application without a graphical user interface that runs in the background. They can be very useful in performing activities (such as getting sensor data in the background) that need to run periodically or continuously, but do not require any user interaction.

  17. Widget Application in wearable applications only -

    The widget application (or widget) is the specialized application that is useful in providing users with quick view of specific information from the parent application. Also, the widget allows users to access certain features without launching the applications. Combined with their parent application, your widgets can have various features to increase usability of your applications.

  18. +

    The widget application (or widget) is a specialized application that provides the user with a quick view of specific information from the parent application. In addition, the widget allows the user to access certain features without launching the parent application. Combined with the parent application, your widget can have various features to increase the usability of your application.

  19. Watch Application in wearable applications only -

    Tizen watch application is one of Tizen Web applications for wearable devices. It can be shown on the idle screen of the wearable device.

  20. +

    The watch application provides a watch face as its user interface, showing the current time and updating it every second. The watch application can be shown on the idle screen of the wearable device.

    Application Package Manager

    diff --git a/org.tizen.guides/html/web/app_management/common_appcontrol_w.htm b/org.tizen.guides/html/web/app_management/common_appcontrol_w.htm index 83d8f70..032b37c 100644 --- a/org.tizen.guides/html/web/app_management/common_appcontrol_w.htm +++ b/org.tizen.guides/html/web/app_management/common_appcontrol_w.htm @@ -2001,7 +2001,7 @@ tizen.application.launchAppControl(appControl, null, function() {

    Showing Location Settings

    To launch the location setting application to allow the user to configure the source of the location information, use the http://tizen.org/appcontrol/operation/setting/location operation.

    -

    If the location service is not active when an application tries to use the HumanActivityMonitorManager interface (in mobile or wearable applications), an error occurs. To solve the problem, the application can try to launch the location setting application to let the user enable the location service. The user can activate the GPS, network positioning using the Wi-Fi Positioning System (WPS) and cellular network, or both.

    +

    If the location service is not active when an application tries to use the HumanActivityMonitorManager interface (in mobile and wearable applications), an error occurs. To solve the problem, the application can try to launch the location setting application to let the user enable the location service. The user can activate the GPS, network positioning using the Wi-Fi Positioning System (WPS) and cellular network, or both.

    Figure: Showing location settings

    Showing location settings Showing location settings

    diff --git a/org.tizen.guides/html/web/app_management/message_port_w.htm b/org.tizen.guides/html/web/app_management/message_port_w.htm index d345a02..f2fad3b 100644 --- a/org.tizen.guides/html/web/app_management/message_port_w.htm +++ b/org.tizen.guides/html/web/app_management/message_port_w.htm @@ -42,7 +42,7 @@

    Message Port

    -

    Tizen Web applications can communicate with other Web or native applications. The message data type for the communication is map data, which consists of a string key and value that can be a string, string array, byte stream, or byte stream array.

    +

    Your Web applications can communicate with other Web or native applications. The message data type for the communication is map data, which consists of a string key and value that can be a string, string array, byte stream, or byte stream array.

    The Message Port API is mandatory for both Tizen mobile and wearable profiles, which means that it is supported in all mobile and wearable devices. All mandatory APIs are supported on the Tizen Emulators.

    @@ -130,7 +130,7 @@ var messageData = [ ]; remotePort.sendMessage(messageData); -

    If you expect a response message, pass the instance of the LocalMessagePort interface as a second parameter of sendMessage() method to specify the message port where the response is sent:

    +

    If you expect a response message, pass the instance of the LocalMessagePort interface as the second parameter of the sendMessage() method to specify the message port where the response is sent:

     remotePort.sendMessage(messageData, localPort);
     
    diff --git a/org.tizen.guides/html/web/app_management/packages_w.htm b/org.tizen.guides/html/web/app_management/packages_w.htm index 6d4a1a8..402da96 100644 --- a/org.tizen.guides/html/web/app_management/packages_w.htm +++ b/org.tizen.guides/html/web/app_management/packages_w.htm @@ -44,7 +44,8 @@

    Package Information

    -

    Package information features include retrieving detailed information about packages, such as package name, icon path, version details, and package ID. You can receive notifications if packages are updated or removed, or new packages are installed. You can also perform package management tasks, such as installing or uninstalling packages.

    + +

    You can retrieve detailed information about packages, such as package name, icon path, version details, and package ID. You can receive notifications if packages are updated or removed, or new packages are installed. You can also perform package management tasks, such as installing or uninstalling packages.

    The Package API is mandatory for both Tizen mobile and wearable profiles, which means that it is supported in all mobile and wearable devices. All mandatory APIs are supported on the Tizen Emulators.

    diff --git a/org.tizen.guides/html/web/app_management/service_app_w.htm b/org.tizen.guides/html/web/app_management/service_app_w.htm index 1e704e3..fc9308b 100644 --- a/org.tizen.guides/html/web/app_management/service_app_w.htm +++ b/org.tizen.guides/html/web/app_management/service_app_w.htm @@ -44,7 +44,7 @@

    Service Application

    -

    A service application is a type of Tizen Web application that provides an environment for running JavaScript in the background without a graphical user interface (the application follows the ECMA-262 specification). The service application is used to perform tasks which need to run periodically or continuously but do not require user interaction. For example, a service application can be used for getting data or listening for platform events in the background. As service applications do not have UI components, they run on top of a more light-weight runtime than UI applications. Therefore, you can expect them to perform better and consume less memory.

    +

    A service application is a type of Tizen Web application that provides an environment for running JavaScript in the background without a graphical user interface (the application follows the ECMA-262 specification). The service application is used to perform tasks that need to run periodically or continuously, but do not require any user interaction. For example, a service application can be used for getting data or listening for platform events in the background. As service applications do not have UI components, they run on top of a more light-weight runtime than UI applications. Therefore, you can expect them to perform better and consume less memory.

    Note @@ -110,7 +110,7 @@
    Note - No privileges need to be separately defined for service applications, since the service application is always packaged with a UI application, and a scope of a privilege defined for the UI application covers the entire application package. + No privileges need to be separately defined for service applications, since the service application is always packaged with a UI application, and a privilege defined for the UI application covers the entire application package.

    Managing the Service Application Life-cycle

    diff --git a/org.tizen.guides/html/web/app_management/web_widget_ww.htm b/org.tizen.guides/html/web/app_management/web_widget_ww.htm index d40b008..1ff8cbf 100644 --- a/org.tizen.guides/html/web/app_management/web_widget_ww.htm +++ b/org.tizen.guides/html/web/app_management/web_widget_ww.htm @@ -47,7 +47,7 @@

    Widget Application

    -

    Widget applications (or simply widgets) are specialized applications useful in providing users with a quick view of specific information from the parent application. Also, widgets allow users to access certain features without launching the parent applications. Combined with the parent application, your widget can have various features to increase the usability of your application set.

    +

    A widget application (or widget) is a specialized application that provides users with a quick view of specific information from the parent application. In addition, the widget can allow the user to access certain features without launching the parent application. Combined with the parent application, your widget can have various features to increase the usability of your application set.

    This feature is supported in wearable applications only.

    @@ -75,7 +75,7 @@
  21. Only JPEG, PNG, and GIF formats are allowed for image files.
  22. -

    You can create a standalone Web widget, with no parent Web application. In this case, the parent Web application is generated automatically by the Tizen Studio during packaging. However, this kind of widget is used for development and testing purposes only. To be published on the Tizen Store, Web widgets must be combined with a real parent application.

    +

    You can create a standalone Web widget, with no parent Web application. In this case, the parent Web application is generated automatically by the Tizen Studio during packaging. However, this kind of widget is used for development and testing purposes only. To be published in the Tizen Store, Web widgets must be combined with a real parent application.

    More than 1 Web widget can be included in a parent Web application, and all widgets and the parent are bundled in 1 package by the Tizen Studio. Web widget resources are included in its Web application package. The Tizen platform installs the Web widget when its parent Web application is installed, and uninstalls the Web widget when its parent Web application is uninstalled. The Web widget resources are all removed together with its parent.

    Figure: Widget and Web application packaging

    @@ -168,7 +168,7 @@ <widget xmlns="http://www.w3.org/ns/widgets" xmlns:tizen="http://tizen.org/ns/widgets" id="http://yourdomain/DynamicSample"> - <!--Information about the widget001--> + <!--Information about widget001--> <tizen:app-widget id="Zyj5WRVa13.DynamicSample.widget001" primary="true"> <tizen:widget-label>TEST_1</tizen:widget-label> <tizen:widget-content src="widget/widget001/index.html"> @@ -176,7 +176,7 @@ </tizen:widget-content> </tizen:app-widget> - <!--Information about the widget002--> + <!--Information about widget002--> <tizen:app-widget id="Zyj5WRVa13.DynamicSample.widget002" primary="false"> <tizen:widget-label>TEST_2</tizen:widget-label> <tizen:widget-content src="widget/widget002/index.html"> @@ -190,7 +190,7 @@ </widget> -
  23. The config.xml file of the widget001: +
  24. The config.xml file for widget001:
     <tizen:app-widget id="Zyj5WRVa13.DynamicSample.widget001" primary="true">
    @@ -201,7 +201,7 @@
     </tizen:app-widget>
     
  25. -
  26. The config.xml file of the widget002: +
  27. The config.xml file for widget002:
     <tizen:app-widget id="Zyj5WRVa13.DynamicSample.widget002" primary="false">
    @@ -625,7 +625,7 @@ function onload() {
     

    Animation

    -

    For simple and smooth animation effect, use the requestAnimationFrame() JavaScript method.

    +

    For simple and smooth animation effects, use the requestAnimationFrame() JavaScript method.

    The following example shows a weather widget implementation with an image animation.

    @@ -1184,7 +1184,7 @@ d.toLocaleTimeString(); /* '7:38:05 AM' */

    Debugging

    -

    You can debug and validate your Web widget. Currently, there are 2 approaches in debugging a Web widget:

    +

    You can debug and validate your Web widget. Currently, there are 2 approaches to debugging a Web widget:

    • Console log
    • Web debugger
    • @@ -1400,7 +1400,7 @@ sdb dlog | grep ConsoleMessage

      What is the best way to use the <img> element?

      -

      To increase performance and reduce memory size, the Web widget engine imposes 2 limitations on the <img> element:

      +

      To increase performance and reduce the memory footprint, the Web widget engine imposes 2 limitations on the <img> element:

      • Supported image file formats: PNG, JPG, GIF
      • diff --git a/org.tizen.guides/html/web/app_management/widget_app_w.htm b/org.tizen.guides/html/web/app_management/widget_app_w.htm index f62ddd3..4b7e91c 100644 --- a/org.tizen.guides/html/web/app_management/widget_app_w.htm +++ b/org.tizen.guides/html/web/app_management/widget_app_w.htm @@ -153,7 +153,7 @@ var name = myWidget.getName('en-us');
        Note - The WidgetInstance.id value is volatile and can change after device reboot. + The WidgetInstance.id value (in mobile and wearable applications) is volatile and can change after device reboot.
          @@ -176,7 +176,7 @@ myWidget.getInstances(successCallback, errorCallback);

          Retrieving Widget Variants

          -

          To retrieve variants representing all of the supported widget size types:

          +

          To retrieve variants representing all the supported widget size types:

          1. Define a success handler implementing the WidgetVariantsCallback interface (in mobile and wearable applications). Optionally, you can specify an error handler too.

            diff --git a/org.tizen.guides/html/web/connectivity/bluetooth_w.htm b/org.tizen.guides/html/web/connectivity/bluetooth_w.htm
            index 0b551fc..42f2260 100644
            --- a/org.tizen.guides/html/web/connectivity/bluetooth_w.htm
            +++ b/org.tizen.guides/html/web/connectivity/bluetooth_w.htm
            @@ -83,7 +83,7 @@
                
          2. Discovering Bluetooth Low Energy devices

            You can discover Bluetooth Low Energy devices in range. Through the discovery process, you can obtain basic information about available remote devices, such as their names and provided services.

          3. Managing the advertising options -

            You can manage advertising to control how your device announces itself to other Bluetooth Low Energy devices to be discovered.

          4. +

            You can manage advertising to control how your device announces itself to other Bluetooth Low Energy devices for discovery.

          5. Connecting to a Bluetooth Low Energy device

            You can connect to a remote Bluetooth Low Energy device. When connected, you can access services and characteristics of the remote device.

          6. Receiving notifications on connection state changes @@ -111,7 +111,7 @@

            Managing the Local Bluetooth Adapter

            You can enable or disable the local Bluetooth adapter, and set the device name using the system-provided service through the ApplicationControl interface (in mobile and wearable applications).

            -

            To use the Bluetooth functionality of the device, you must switch the Bluetooth adapter on. The Bluetooth API does not provide a method to enable or disable the Bluetooth adapter of the device directly. Whenever Bluetooth is required, request a built-in Settings application to present the relevant switch to the user so that they can enable or disable the Bluetooth.

            +

            To use the Bluetooth functionality of the device, you must switch the Bluetooth adapter on. The Bluetooth API does not provide a method to enable or disable the Bluetooth adapter of the device directly. When Bluetooth is required, you must request the built-in Settings application on the device to let the user enable or disable Bluetooth.

            Figure: Bluetooth setting screen

            Bluetooth setting screen

              diff --git a/org.tizen.guides/html/web/connectivity/download_w.htm b/org.tizen.guides/html/web/connectivity/download_w.htm index b5e9c00..0111cca 100644 --- a/org.tizen.guides/html/web/connectivity/download_w.htm +++ b/org.tizen.guides/html/web/connectivity/download_w.htm @@ -46,7 +46,7 @@

              Content Downloads

              -

              Tizen enables you to download files from the Internet. You can also monitor the download progress and status.

              +

              You can download files from the Internet and monitor the progress and status of ongoing downloads.

              The Download API is mandatory for the Tizen mobile profile, but optional for the wearable profile. This means that it is supported in all mobile devices, but may not be supported in all wearable devices. The Download API is supported on all Tizen Emulators.

              @@ -72,7 +72,7 @@
               var downloadRequest = new tizen.DownloadRequest('http://download.tizen.org/tools/README.txt', 'downloads');
               
              -

              The final parameter (downloads) defines the folder where the downloaded content is stored. The parameter uses a relative folder location defined in the Filesystem API (in mobile, wearable, and TV applications). The folder is not an absolute folder location, but instead uses a virtual root location (downloads is the default download location in the virtual root).

              +

              The final parameter (downloads) defines the folder where the downloaded content is stored. The parameter uses a relative folder location defined in the Filesystem API (in mobile, wearable, and TV applications). The folder is not an absolute folder location, but instead uses a virtual root location (downloads is the default download location in the virtual root).

            1. It is not possible to download anything when the device is not connected to a network. To check whether any connection is available, use the getPropertyValue() method of the SystemInfo interface (in mobile, wearable, and TV applications):

               tizen.systeminfo.getPropertyValue('NETWORK', function(networkInfo) {
              @@ -113,7 +113,7 @@ var listener = {
                   }
               };
               
            2. -
            3. To start the download of the HTML file from the Internet, use the start() method of the DownloadManager interface (in mobile, wearable, and TV applications):

              +
            4. To start downloading the file from the Internet, use the start() method of the DownloadManager interface (in mobile, wearable, and TV applications):

               downloadId = tizen.download.start(downloadRequest, listener);
               
              @@ -157,7 +157,7 @@ var downloadRequest = tizen.download.getDownloadRequest(downloadId);
               var MIMEType = tizen.download.getMIMEType(downloadId);
               
              -

              The method returns the MIME type the target file which has started downloading.

            5. +
            diff --git a/org.tizen.guides/html/web/connectivity/iotcon_w.htm b/org.tizen.guides/html/web/connectivity/iotcon_w.htm index 3b585bb..5477b14 100644 --- a/org.tizen.guides/html/web/connectivity/iotcon_w.htm +++ b/org.tizen.guides/html/web/connectivity/iotcon_w.htm @@ -90,10 +90,12 @@
          7. To make your application visible in the Tizen Store only for devices that support Iotcon, the application must specify the following feature in the config.xml file:
            -<feature name="http://tizen.org/feature/iot.ocf"/>
            +<widget>
            +   <feature name="http://tizen.org/feature/iot.ocf"/>
            +</widget>
             
            -

            You can also check whether a device supports the API by using the tizen.systeminfo.getCapability() method and accordingly enabling or disabling the code requiring the API:

            +

            Additionally, to double-check the for Iotcon API support while the application is running, use the tizen.systeminfo.getCapability() method and enable or disable the code that needs the API, as needed:

             try {
            @@ -125,7 +127,7 @@ var cborPath = 'path_to_my_app_storage/iotcon-server-test.dat';
             
          8. -

            Initialize Iotcon and set a human friendly name:

            +

            Initialize Iotcon and set a human-friendly name:

             tizen.iotcon.initialize(cborPath);
             tizen.iotcon.deviceName = 'Device 1';
            @@ -224,7 +226,7 @@ var cborPath = 'path_to_my_app_storage/iotcon-client-test.dat';
             
          9. -

            Initialize Iotcon and set a human friendly name:

            +

            Initialize Iotcon and set a human-friendly name:

             tizen.iotcon.initialize(cborPath);
             tizen.iotcon.deviceName = 'Device 2';
            diff --git a/org.tizen.guides/html/web/connectivity/nfc_w.htm b/org.tizen.guides/html/web/connectivity/nfc_w.htm
            index ea01d68..ee40592 100644
            --- a/org.tizen.guides/html/web/connectivity/nfc_w.htm
            +++ b/org.tizen.guides/html/web/connectivity/nfc_w.htm
            @@ -87,7 +87,7 @@
             
             
            Note - Tizen provides the following NFC tag types: GENERIC_TARGET, ISO14443_A, ISO14443_4A, ISO14443_3A, MIFARE_MINI, MIFARE_1K, MIFARE_4K, MIFARE_ULTRA, MIFARE_DESFIRE, ISO14443_B, ISO14443_4B, ISO14443_BPRIME, FELICA, JEWEL, ISO15693, and UNKNOWN_TARGET. + Tizen supports the following NFC tag types: GENERIC_TARGET, ISO14443_A, ISO14443_4A, ISO14443_3A, MIFARE_MINI, MIFARE_1K, MIFARE_4K, MIFARE_ULTRA, MIFARE_DESFIRE, ISO14443_B, ISO14443_4B, ISO14443_BPRIME, FELICA, JEWEL, ISO15693, and UNKNOWN_TARGET.

            The NFC forum defines the NFC data exchange format (NDEF) for encapsulating the data exchanged between 2 NFC-enabled devices or an NFC-enabled device and an NFC tag. An NDEF message can store data in various formats, such as text, Multipurpose Internet Mail Extension (MIME) type object, or ultra-short RagTime Document (RTD). The NFC tags use NDEF for exchanging messages. Tizen provides the NDEFMessage interface (in mobile and wearable applications) to define an NDEF message.

            @@ -126,7 +126,7 @@
            Note - The NFC API does not provide methods to directly enable or disable the NFC adapter of the device. When NFC is required, you must request the built-in Settings application to let the user enable or disable the NFC. + The NFC API does not provide methods to directly enable or disable the NFC adapter of the device. When NFC is required, you must request the built-in Settings application to let the user enable or disable NFC.

            To enable or disable the NFC service:

            diff --git a/org.tizen.guides/html/web/connectivity/secure_element_w.htm b/org.tizen.guides/html/web/connectivity/secure_element_w.htm index 0b8a310..a39b466 100644 --- a/org.tizen.guides/html/web/connectivity/secure_element_w.htm +++ b/org.tizen.guides/html/web/connectivity/secure_element_w.htm @@ -44,7 +44,7 @@

            Secure Element Access

            -

            Tizen enables you to access secure elements in a device. You can access various secure elements, such as UICC and SIM cards, embedded secure elements, and secure SD cards.

            +

            You can access secure elements in a device. You can access various secure elements, such as UICC and SIM cards, embedded secure elements, and secure SD cards.

            This feature is supported in mobile and wearable applications only.

            diff --git a/org.tizen.guides/html/web/cordova/console_w.htm b/org.tizen.guides/html/web/cordova/console_w.htm index fc7d025..56b5976 100644 --- a/org.tizen.guides/html/web/cordova/console_w.htm +++ b/org.tizen.guides/html/web/cordova/console_w.htm @@ -62,7 +62,7 @@
            Note - To see the results of the message writing, use the system console available in your Tizen Studio or use the sdb dlog command. + To see the message writing results, use the system console in the Tizen Studio or use the sdb dlog command.

            The global console object contains some additional features defined by Cordova.

            diff --git a/org.tizen.guides/html/web/cordova/file_w.htm b/org.tizen.guides/html/web/cordova/file_w.htm index f0218fa..7e47ede 100644 --- a/org.tizen.guides/html/web/cordova/file_w.htm +++ b/org.tizen.guides/html/web/cordova/file_w.htm @@ -123,7 +123,7 @@ File system name temporary
          10. Use the resolveLocalFileSystemURL() global async method. -

            This method is used to retrieve a DirectoryEntry objects (in mobile, wearable, or TV applications) or FileEntry objects (in mobile, wearable, or TV applications) using a local URI.

            +

            This method is used to retrieve DirectoryEntry objects (in mobile, wearable, and TV applications) or FileEntry objects (in mobile, wearable, and TV applications) using a local URI.

            1. Define the callbacks:
               successCallback = function(entry) {
              @@ -186,7 +186,7 @@ Created file: qa.txt
               
            2. -
            3. To delete a directory and all of its content, you can use the removeRecursively() method: +
            4. To delete a directory and its entire content, you can use the removeRecursively() method:
               requestFileSystem(TEMPORARY, 100, function(fs) {
                   fs.root.getDirectory('testDirectory', {create:true}, function(directoryEntry) {
              diff --git a/org.tizen.guides/html/web/data/data_filter_w.htm b/org.tizen.guides/html/web/data/data_filter_w.htm
              index 0e0b3a8..9297178 100644
              --- a/org.tizen.guides/html/web/data/data_filter_w.htm
              +++ b/org.tizen.guides/html/web/data/data_filter_w.htm
              @@ -158,7 +158,7 @@ tizen.contact.getDefaultAddressBook().find(successCB, errorCB, null, sortMode);
               
              Note If you use a type attribute as a sort mode parameter, the sorting is not performed alphabetically since the attribute values are stored normally after the type conversion in the platform implementation. -

              For example, if the ContentType enum (in mobile, wearable, and TV applications) is the type attribute and the sorting order is "DESC", the sorting result is ordered according to the listed enum order:

              +

              For example, if the ContentType enumeration (in mobile, wearable, and TV applications) is the type attribute and the sorting order is "DESC", the sorting result is ordered according to the listed enumerator order:

              • Image
              • Video
              • Audio
              • Other
              diff --git a/org.tizen.guides/html/web/data/file_archiving_w.htm b/org.tizen.guides/html/web/data/file_archiving_w.htm index abf3b89..cd25679 100644 --- a/org.tizen.guides/html/web/data/file_archiving_w.htm +++ b/org.tizen.guides/html/web/data/file_archiving_w.htm @@ -47,7 +47,7 @@

              File Archiving

              -

              Tizen enables you to operate on ZIP archive files.

              +

              You can manage ZIP archives and operate on the archived files.

              The Archive API is mandatory for both Tizen mobile and wearable profiles, which means that it is supported in all mobile and wearable devices. All mandatory APIs are supported on the Tizen Emulators.

              diff --git a/org.tizen.guides/html/web/data/file_system_w.htm b/org.tizen.guides/html/web/data/file_system_w.htm index 9da0bef..76e365d 100644 --- a/org.tizen.guides/html/web/data/file_system_w.htm +++ b/org.tizen.guides/html/web/data/file_system_w.htm @@ -53,7 +53,7 @@

              File System

              -

              Tizen enables you to access the files and directories in the device file system.

              +

              You can access the files and directories in the device file system.

              The Filesystem API is mandatory for both Tizen mobile and wearable profiles, which means that it is supported in all mobile and wearable devices. All mandatory APIs are supported on the Tizen Emulators.

              diff --git a/org.tizen.guides/html/web/data/stored_content_w.htm b/org.tizen.guides/html/web/data/stored_content_w.htm index c814511..f87e3c1 100644 --- a/org.tizen.guides/html/web/data/stored_content_w.htm +++ b/org.tizen.guides/html/web/data/stored_content_w.htm @@ -60,7 +60,7 @@

              Stored Content Management

              -

              Tizen enables you to search for content (images, videos, music or other) located on the local device storage. You can also perform content management tasks, such as viewing and updating content attributes.

              +

              You can search for content (such as images, videos, and music) located in the local device storage. You can also perform content management tasks, such as viewing and updating content attributes.

              The Content API is mandatory for both Tizen mobile and wearable profiles, which means that it is supported in all mobile and wearable devices. All mandatory APIs are supported on the Tizen Emulators.

              @@ -381,7 +381,7 @@ tizen.content.getPlaylists(function(playlists) { });
              -

              The example above moves the track 2 positions up on the playlist. The second parameter of the move() method can be a negative value, which means moving the track up, or a positive value, which means moving the track down. If the value is greater than number of tracks above or below, the item is accordingly moved to the beginning or end of the playlist.

              +

              The example above moves the track 2 positions up on the playlist. The second parameter of the move() method can be a negative value, which means moving the track up, or a positive value, which means moving the track down. If the value is greater than number of tracks above or below, the item is moved accordingly to the beginning or end of the playlist.

            5. diff --git a/org.tizen.guides/html/web/device/feedback_w.htm b/org.tizen.guides/html/web/device/feedback_w.htm index d485d80..87ca790 100644 --- a/org.tizen.guides/html/web/device/feedback_w.htm +++ b/org.tizen.guides/html/web/device/feedback_w.htm @@ -39,7 +39,7 @@
  28. Sound and Vibration Feedback

    -

    Tizen enables you to handle feedback patterns (media or vibration) that can be played as a reaction to specified actions.

    +

    You can handle feedback patterns (media or vibration) that can be played as a reaction to specified actions.

    This feature is supported in mobile and wearable applications only.

    diff --git a/org.tizen.guides/html/web/device/power_w.htm b/org.tizen.guides/html/web/device/power_w.htm index 625b1b2..7f8c64c 100644 --- a/org.tizen.guides/html/web/device/power_w.htm +++ b/org.tizen.guides/html/web/device/power_w.htm @@ -44,7 +44,7 @@

    Power States

    -

    Tizen enables you to access a device's power resources. Currently, the screen and CPU power resources are supported, allowing you to request a specific power state and control the brightness of the screen.

    +

    You can access a device's power resources. Currently, the screen and CPU power resources are supported, allowing you to request a specific power state and control the brightness of the screen.

    This feature is supported in mobile and wearable applications only.

    diff --git a/org.tizen.guides/html/web/device/system_information_w.htm b/org.tizen.guides/html/web/device/system_information_w.htm index dc011a9..eff13e5 100644 --- a/org.tizen.guides/html/web/device/system_information_w.htm +++ b/org.tizen.guides/html/web/device/system_information_w.htm @@ -161,7 +161,7 @@ function onPowerSuccessCallback(battery) { var charging = battery.isCharging; } -
  29. Retrieve the current states of a specific device property using the getPropertyValueArray() method. For example, you can check the state of SIM cards, which are mounted in the Tizen device.

    +
  30. Retrieve the current states of a specific device property using the getPropertyValueArray() method. For example, you can check the state of SIM cards mounted in the Tizen device.

     function successCallback(properties) {
    @@ -174,7 +174,7 @@ function successCallback(properties) {
     tizen.systeminfo.getPropertyValueArray('SIM', successCallback);
     
  31. -
  32. Retrieve the number of system property information using the getCount() method. For example, you can check the number of SIM cards, which are installed in the Tizen device.

    +
  33. Retrieve the number of system property information using the getCount() method. For example, you can check the number of SIM cards installed in the Tizen device.

     console.log('The number of SIM cards in the device is ' + tizen.systeminfo.getCount('SIM'));
    diff --git a/org.tizen.guides/html/web/device/time_w.htm b/org.tizen.guides/html/web/device/time_w.htm
    index 01c0e7a..2c0a123 100644
    --- a/org.tizen.guides/html/web/device/time_w.htm
    +++ b/org.tizen.guides/html/web/device/time_w.htm
    @@ -53,7 +53,7 @@
     
      

    Time and Date Management

    -

    Tizen enables you to use locale-specific calendar features by retrieving date and time information. You can also change the date, time, and time zone, and make some date- and time-related calculations. The Time API overcomes several limitations of the JavaScript Date object.

    +

    You can use locale-specific calendar features by retrieving date and time information. You can also change the date, time, and time zone, and make some date- and time-related calculations. The Time API overcomes several limitations of the JavaScript Date object.

    The Time API is mandatory for both Tizen mobile and wearable profiles, which means that it is supported in all mobile and wearable devices. All mandatory APIs are supported on the Tizen Emulators.

    diff --git a/org.tizen.guides/html/web/device/web_view_w.htm b/org.tizen.guides/html/web/device/web_view_w.htm index 14398a2..e1f8f9f 100644 --- a/org.tizen.guides/html/web/device/web_view_w.htm +++ b/org.tizen.guides/html/web/device/web_view_w.htm @@ -41,8 +41,7 @@

    Web View Settings

    - -

    Tizen enables you to set Web view properties.

    +

    You can set Web view properties.

    This feature is supported in mobile and TV applications only.

    diff --git a/org.tizen.guides/html/web/guides_w.htm b/org.tizen.guides/html/web/guides_w.htm index abb8a7a..b5d4c7e 100644 --- a/org.tizen.guides/html/web/guides_w.htm +++ b/org.tizen.guides/html/web/guides_w.htm @@ -121,7 +121,7 @@ Note In Tizen Web Device APIs, there are 2 types of APIs: mandatory and optional.

    The mandatory APIs are always available on all Tizen devices. The optional APIs provide functionality that depends on the available device hardware or software capabilities, and they may not be available on all Tizen devices. For example, the Bluetooth and NFC API hardware features are optional, and not supported on all devices.

    -

    To determine the availability of optional APIs, use the tizen.systeminfo.getCapability() method of the System Information API (in mobile, wearable, and TV applications).

    +

    To determine the availability of optional APIs, use the tizen.systeminfo.getCapability() method of the System Information API (in mobile, wearable, and TV applications).

    Note that all mandatory APIs are supported on the Tizen Emulators, while the optional APIs may or may not be supported. For more information on support for each API, see Tizen Web Device API Reference.

    diff --git a/org.tizen.guides/html/web/localization/localization_w.htm b/org.tizen.guides/html/web/localization/localization_w.htm index 7ec24bc..7902467 100644 --- a/org.tizen.guides/html/web/localization/localization_w.htm +++ b/org.tizen.guides/html/web/localization/localization_w.htm @@ -37,7 +37,7 @@

    To localize a Tizen Web application:

    1. Create a directory for each locale. -

      Create a directory for each locale that has localized content under the locales directory in package root. The locale names are defined in the W3C IANA language subtag registry.

      +

      Create a directory for each locale that has localized content under the locales directory in package root. The locale names are defined in the W3C IANA Language Subtag Registry.

      The Web Runtime loads the proper resource for the current locale according to the W3C widget using the following mark-up:

      @@ -99,7 +99,7 @@ log('hello=' + LANG_JSON_DATA['hello']);
                   Bengalibn-in
                   Bulgarianbg-bg
                   Catalanca-es
      -            Chinese Simplified (中文 简体)zh-cn
      +            Chinese Simplified (China)zh-cn
                   Chinese Traditional (Hong Kong)zh-hk
                   Chinese Traditional (Taiwan)zh-tw
                   Croatianhr-hr
      @@ -164,7 +164,7 @@ log('hello=' + LANG_JSON_DATA['hello']);
                   Slovakiansk-sk
                   Sloveniansl-si
                   Spanish (Spain)es-es
      -            Spanish (Latin)es-us
      +            Spanish (Latin America)es-us
                   Swedishsv-se
                   Tamilta-in
                   Telugute-in
      diff --git a/org.tizen.guides/html/web/media/audio_w.htm b/org.tizen.guides/html/web/media/audio_w.htm
      index 16ffd17..6bbe76b 100644
      --- a/org.tizen.guides/html/web/media/audio_w.htm
      +++ b/org.tizen.guides/html/web/media/audio_w.htm
      @@ -46,7 +46,7 @@
       

      Audio Management

      -

      Tizen enables you to control the volume level of several sound types and get information about the current sound mode and the state of the current sound devices. The available sound types include, for example, system, notifications, alarms, and media.

      +

      You can control the volume level of several sound types and get information about the current sound mode and the state of the current sound devices. The available sound types include, for example, system, notifications, alarms, and media.

      This feature is supported in mobile and wearable applications only.

      diff --git a/org.tizen.guides/html/web/media/jpeg_exif_w.htm b/org.tizen.guides/html/web/media/jpeg_exif_w.htm index c5545e3..ea251a4 100644 --- a/org.tizen.guides/html/web/media/jpeg_exif_w.htm +++ b/org.tizen.guides/html/web/media/jpeg_exif_w.htm @@ -47,7 +47,7 @@

      JPEG File EXIF Information

      -

      Tizen enables you to access and modify EXIF information in a JPEG file (with the common .jpg extension).

      +

      You can access and modify EXIF information in a JPEG file (with the common .jpg extension).

      The Exif API is mandatory for both Tizen mobile and wearable profiles, which means that it is supported in all mobile and wearable devices. All mandatory APIs are supported on the Tizen Emulators.

      @@ -63,7 +63,7 @@

      Learning how to retrieve EXIF data from JPEG files is a useful content management skill:

        -
      1. To retrieve the EXIF data from specific file, you need the URI of an image file in an absolute URI format (for example file:///opt/usr/media/Images/tizen.jpg). The tizen.filesystem.resolve() and toURI() methods can be used to convert a virtual path to a URI.

        +
      2. To retrieve the EXIF data from an image file, you need the absolute URI of the file (for example file:///opt/usr/media/Images/tizen.jpg). The tizen.filesystem.resolve() and toURI() methods can be used to convert a virtual path to a URI.

         var fileURI = '';
        @@ -95,7 +95,7 @@ tizen.exif.getExifInfo(fileURI, onSuccess, onError);
         

        With a valid exifInfo object, you can access various ExifInformation attributes (in mobile, wearable, and TV applications), such as width, height, orientation, and flash.

      3. -
      4. To retrieve an EXIF thumbnail of the image: +
      5. To retrieve the EXIF thumbnail from the image:
        1. Resolve the input JPEG file:
          diff --git a/org.tizen.guides/html/web/media/media_controller_w.htm b/org.tizen.guides/html/web/media/media_controller_w.htm
          index 53634c8..df52b13 100644
          --- a/org.tizen.guides/html/web/media/media_controller_w.htm
          +++ b/org.tizen.guides/html/web/media/media_controller_w.htm
          @@ -44,7 +44,7 @@
           

          Media Controller

          -

          Tizen provides a functionality for you to communicate between the media controller server and client.

          +

          You can have your client application communicate with a media server.

          This feature is supported in mobile and wearable applications only.

          @@ -61,7 +61,7 @@

          You can send a request from the client to the server to modify various playback attributes. In the server, you can set up a listener to react to the client request and perform the requested task.

        2. Receiving notifications from the server -

          You can receive notifications on changed made by the server by registering a listener with the addPlaybackInfoChangeListener() method.

        3. +

          You can receive notifications on changes made by the server by registering a listener with the addPlaybackInfoChangeListener() method.

        4. Sending custom commands

          You can use the client to send commands with the sendCommand() method.

          @@ -96,7 +96,7 @@ var mcClient = tizen.mediaController.getClient();
    2. -
    3. Define a success (and optionally error) event handler by implementing the MediaControllerServerInfoArraySuccessCallback interface (in mobile and wearable applications): +
    4. Define a success (and optionally, an error) event handler by implementing the MediaControllerServerInfoArraySuccessCallback interface (in mobile and wearable applications):
       var mcServerInfo;
      @@ -247,7 +247,7 @@ var exampleCustomCommandData = {
       
    5. -
    6. Define a success (and optionally error) callback implementing the MediaControllerSendCommandSuccessCallback interface (in mobile and wearable applications): +
    7. Define a success (and optionally, an error) callback implementing the MediaControllerSendCommandSuccessCallback interface (in mobile and wearable applications):
       function sendCommandSuccessCallback(response) {
      diff --git a/org.tizen.guides/html/web/media/media_key_w.htm b/org.tizen.guides/html/web/media/media_key_w.htm
      index a4213bc..932898a 100644
      --- a/org.tizen.guides/html/web/media/media_key_w.htm
      +++ b/org.tizen.guides/html/web/media/media_key_w.htm
      @@ -40,7 +40,7 @@
       

      Media Key Events

      -

      Tizen enables you to handle media keys in your application. The media keys are used to control multimedia playback. The user can click keys, such as PLAY and FAST FORWARD, and you can detect the key clicks in your application and change the playback accordingly.

      +

      You can manage media key events in your application. The media keys are used to control multimedia playback. The user can click keys, such as PLAY and FAST FORWARD, and you can detect the key clicks in your application and change the playback accordingly.

      This feature is supported in mobile and wearable applications only.

      diff --git a/org.tizen.guides/html/web/media/player_util_w.htm b/org.tizen.guides/html/web/media/player_util_w.htm index 87b3359..a669554 100644 --- a/org.tizen.guides/html/web/media/player_util_w.htm +++ b/org.tizen.guides/html/web/media/player_util_w.htm @@ -41,7 +41,7 @@

      Audio Latency

      -

      Tizen enables you to control the audio latency mode of the W3C player.

      +

      You can control the audio latency mode of the W3C player.

      This feature is supported in mobile and wearable applications only.

      The main features of the Player Util API include:

      diff --git a/org.tizen.guides/html/web/media/radio_w.htm b/org.tizen.guides/html/web/media/radio_w.htm index 2a70338..c5452fc 100644 --- a/org.tizen.guides/html/web/media/radio_w.htm +++ b/org.tizen.guides/html/web/media/radio_w.htm @@ -41,7 +41,7 @@

      Radio

      -

      Tizen enables you to access and control the FM radio on the device.

      +

      You can access and control the FM radio on the device.

      This feature is supported in mobile applications only.

      @@ -54,10 +54,9 @@
    8. Getting information about interruptions

      The Tizen system has a feature to prevent interference between the radio and other sound sources. The radio sound is interrupted in reaction to various events, such as an incoming call or notification. You can use the oninterrupted event handler to detect the reason for the interruption.

    9. -

      The available operations depend on the current radio state. To get information about the current radio state, read the state attribute of the FMRadioManager interface (the RadioState enum specifies the possible state values). The following figure illustrates the radio states and transitions between them.

      +

      The available operations depend on the current radio state. To get information about the current radio state, read the state attribute of the FMRadioManager interface (the RadioState enumeration specifies the possible state values). The following figure illustrates the radio states and transitions between them.

      Figure: FM radio states and transitions

      FM radio states and transitions

      -

      Managing the FM Radio

      diff --git a/org.tizen.guides/html/web/messaging/messages_w.htm b/org.tizen.guides/html/web/messaging/messages_w.htm index 4d962c4..b9b98d6 100644 --- a/org.tizen.guides/html/web/messaging/messages_w.htm +++ b/org.tizen.guides/html/web/messaging/messages_w.htm @@ -48,7 +48,7 @@

      Messages

      -

      Tizen enables you to create applications with messaging functionalities for SMS, MMS, and email.

      +

      You can use messaging functionalities, such as SMS, MMS, and email.

      This feature is supported in mobile applications only.

      diff --git a/org.tizen.guides/html/web/messaging/push_w.htm b/org.tizen.guides/html/web/messaging/push_w.htm index f1e1bf9..b6e0cd2 100644 --- a/org.tizen.guides/html/web/messaging/push_w.htm +++ b/org.tizen.guides/html/web/messaging/push_w.htm @@ -46,11 +46,11 @@

      Push Notification

      -

      Tizen enables you to receive notifications from a push server. The push service is a client daemon that maintains a permanent connection between the device and the push server. Push enables you to push events from an application server to your application on a Tizen device. Connection with the push service is used to deliver push notifications to the application, and process the registration and deregistration requests.

      +

      You can receive notifications from a push server. The push service is a client daemon that maintains a permanent connection between the device and the push server. Push enables you to push events from an application server to your application on a Tizen device. Connection with the push service is used to deliver push notifications to the application, and process the registration and deregistration requests.

      This feature is supported in mobile and wearable applications only.

      -

      Push notification helps your application server send data to the application on devices over network even if the application is not running. Push service can reduce battery consumption and data transfer.

      +

      Push notification helps your application server send data to your application on a device over a network, even if the application is not running. Using the push service can reduce battery consumption and data transfer.

      If a push message arrives when the application is running, the message is automatically delivered to the application. If the application is not running, the push service makes a sound or vibrates and adds a ticker or a badge notification to notify the user. By touching this notification, the user can check the message. If the application server sends a message with a LAUNCH option, the push service forcibly launches the application and hands over the message to the application.

      @@ -103,24 +103,24 @@
    10. Make sure the following requirements are fulfilled:

      -
        +
        • Internet access

          To connect to the Tizen push server and receive notifications from it, the target device or emulator must be able to contact any IP address with the port 5223. If you are in an enterprise network, ensure that the proxy setting in your local network allows outgoing traffic destined for this port number.

        • Package ID

          When you create a project in the Tizen Studio, you are given the package ID (randomly generated by the Tizen Studio or entered by yourself). The Tizen push server identifies your applications using the package ID.

        • -
        • Permission to Tizen push servers -

          To use the push messaging service, the application needs the permission to access the Tizen push server. Request the permission from the Tizen push service team using one of the following online request forms:

          +
        • Push server access +

          To use the push messaging service, the application needs permission to access the Tizen push server. Request permission from the Tizen push service team using one of the following online request forms:

          When the team approves the request, you receive a push app ID corresponding to your package ID.

        • -
      +
    diff --git a/org.tizen.guides/html/web/notification/notification_w.htm b/org.tizen.guides/html/web/notification/notification_w.htm index cf01e18..e628a48 100644 --- a/org.tizen.guides/html/web/notification/notification_w.htm +++ b/org.tizen.guides/html/web/notification/notification_w.htm @@ -46,7 +46,7 @@

    Notifications

    -

    Tizen enables you to provide notifications about application events.

    +

    You can provide notifications to the user about application events.

    This feature is supported in mobile and wearable applications only.

    @@ -103,7 +103,7 @@ var notificationGroupDict = { } };
    -

    The path in the iconPath and soundPath parameters means a relative file location defined in the Filesystem API (in mobile and wearable applications). The path is not an absolute file location, but instead uses a virtual root location (such as images in images/image1.jpg).

  34. +

    The path in the iconPath and soundPath parameters means a relative file location defined in the Filesystem API (in mobile and wearable applications). The path is not an absolute file location, but instead uses a virtual root location (such as images in images/image1.jpg).

  35. To be able to display the notification, create a UserNotification object (in mobile and wearable applications) with the notification type, title, and the additional notification properties defined in the previous step.

     var notification = new tizen.UserNotification('SIMPLE', 'Simple notification', notificationGroupDict);
    @@ -139,7 +139,7 @@ var notificationGroupDict = {
         },
     };
     
    -

    The path in the iconPath parameter means a file location defined in the Filesystem API (in mobile and wearable applications). The path is not an absolute file location, but instead uses a virtual root location (such as images in images/image1.jpg).

  36. +

    The path in the iconPath parameter means a file location defined in the Filesystem API (in mobile and wearable applications). The path is not an absolute file location, but instead uses a virtual root location (such as images in images/image1.jpg).

  37. To be able to display the notification, create a UserNotification object (in mobile and wearable applications) with the notification type, title, and the additional notification properties defined in the previous step:

     var notification = new tizen.UserNotification('PROGRESS', 'Progress notification', notificationGroupDict);
    @@ -158,7 +158,8 @@ function updateProgressNotification(progress) {
         }
     }
     
  38. -
  39. To post the notification, use the post() method of the NotificationManager interface. If the progress value is set, the progress bar is displayed in the notification. The progress value can change the amount of progress as it moves forward or backward.

    The application must keep the progress value for its job, because the saved value in the notification status tray can be different (rounded) from the exact progress value.

    +
  40. To post the notification, use the post() method of the NotificationManager interface. If the progress value is set, the progress bar is displayed in the notification. The progress value can change the amount of progress as it moves forward or backward. +

    The application must keep the progress value for its job, because the saved value in the notification panel can be different (rounded) from the exact progress value.

     tizen.notification.post(notification);
     updateProgressNotification(0);
    diff --git a/org.tizen.guides/html/web/personal/calendar_w.htm b/org.tizen.guides/html/web/personal/calendar_w.htm
    index 159afc6..1224a0d 100644
    --- a/org.tizen.guides/html/web/personal/calendar_w.htm
    +++ b/org.tizen.guides/html/web/personal/calendar_w.htm
    @@ -66,7 +66,7 @@
     
       

    Calendar

    -

    Tizen enables you to manage your schedule and tasks in calendars. A calendar is a collection of events or tasks, depending upon the calendar type. Each event or task has a series of attributes, such as purpose, starting time, and duration.

    +

    You can manage your schedule and tasks in calendars. A calendar is a collection of events or tasks, depending on the calendar type. Each event or task has a series of attributes, such as purpose, starting time, and duration.

    This feature is supported in mobile and wearable applications only.

    @@ -178,7 +178,7 @@ tizen.calendar.getUnifiedCalendar('EVENT');
    Note - Due to time zone and daylight saving time, an event for "today" can actually occur in the past or in the future. + Depending on the time zone and daylight saving time, an event for "today" can actually occur in the past or in the future.

    Using the CalendarEvent object (in mobile and wearable applications), you can:

    diff --git a/org.tizen.guides/html/web/personal/call_history_w.htm b/org.tizen.guides/html/web/personal/call_history_w.htm index e6c69a9..a09d3f4 100644 --- a/org.tizen.guides/html/web/personal/call_history_w.htm +++ b/org.tizen.guides/html/web/personal/call_history_w.htm @@ -97,7 +97,7 @@ var filter = new tizen.AttributeFilter('type', 'EXACTLY', 'TEL'); /* Second filter example */ var numberFilter = new tizen.AttributeFilter('remoteParties.remoteParty', 'EXACTLY', '123456789');
  41. -
  42. The CompositeFilter type represents a set of filters. The UNION type composite filter matches any object that is matched by any of its filters; the INTERSECTION type composite filter matches all objects that are matched by all of its filters.

    For example, the following code snippet defines a set of filters that include in the query results only the video calls where the remote party has the telephone number 123456789 and the call has started during the year 2009 or 2011:

    +
  43. The CompositeFilter type represents a set of filters. The UNION type composite filter matches any object that is matched by any of its filters; the INTERSECTION type composite filter matches all objects that are matched by all its filters.

    For example, the following code snippet defines a set of filters that include in the query results only the video calls where the remote party has the telephone number 123456789 and the call has started during the year 2009 or 2011:

     /* Create the ranges for the time filter */
     var y2009Filter = new tizen.AttributeRangeFilter('startTime',
    diff --git a/org.tizen.guides/html/web/personal/contacts_w.htm b/org.tizen.guides/html/web/personal/contacts_w.htm
    index 26df643..46704b2 100644
    --- a/org.tizen.guides/html/web/personal/contacts_w.htm
    +++ b/org.tizen.guides/html/web/personal/contacts_w.htm
    @@ -74,7 +74,7 @@
     
       

    Contacts

    -

    Tizen enables you to manage the contacts and persons listed in your address books. A Contact object (in mobile and wearable applications) is always associated with a specific address book. A Person object (in mobile and wearable applications) is an aggregation of 1 or more contacts associated with the same person.

    +

    You can manage the contacts and persons listed in your address books. A Contact object (in mobile and wearable applications) is always associated with a specific address book. A Person object (in mobile and wearable applications) is an aggregation of 1 or more contacts associated with the same person.

    This feature is supported in mobile and wearable applications only.

    @@ -182,7 +182,7 @@ var addressBook; function addressBooksCB(addressBooks) { if (addressBooks.length > 0) { addressBook = addressBooks[0]; - console.log('The addressbook name is ' + addressBook.name); + console.log('The address book name is ' + addressBook.name); } } @@ -504,7 +504,7 @@ function personsFoundCB(persons) { }
-
  • To get and reset the number of person's calls, messages, and emails: +
  • To get or reset the number of person's calls, messages, and emails:

    You can get the total number of each person's calls, messages, and emails by using the getUsageCount() method. You can also reset the usage count of a person using the resetUsageCount() method of the Person interface (in mobile and wearable applications), which works in a synchronous mode. To reset the usage count for multiple persons, use the resetUsageCountBatch() method, which works in an asynchronous mode.

    Group

    -

    Sometimes, you need to animate all objects with the same animation. To make an animation group for this purpose, the target() method is provided. If all classes of DOM are box, you can create a box group. Like a CSS selector, '.' means a class selector and '#' means an ID selector. Also, a pure HTML element can be a parameter of the target() method.

    +

    Sometimes, you need to animate all objects with the same animation. To make an animation group for this purpose, the target() method is provided. If all classes of DOM are box, you can create a box group. Like in CSS selectors, '.' is a class selector and '#' is an ID selector. Also, a pure HTML element can be a parameter of the target() method.

     <div class="box"></div>
     <div class="box"></div>
    @@ -257,7 +261,7 @@ t('#blueBox').tween({translateY: [0, 150], rotateZ: [0, 180]}, {
         }
     });
     
    -

    In the above animation, the box is translated by Y axis from 0 to 150 and rotated from 0 to 180. Before translating and rotating, the start text is inserted into the box. After translating and rotating, the box's background color is changed to navy.

    +

    In the above animation, the box is translated along the Y axis from 0 to 150 and rotated from 0 to 180. Before translating and rotating, the start text is inserted into the box. After translating and rotating, the box's background color is changed to navy.

    diff --git a/org.tizen.guides/html/web/ui/tau/creating_animation_w.htm b/org.tizen.guides/html/web/ui/tau/creating_animation_w.htm index 0205fab..8592f39 100644 --- a/org.tizen.guides/html/web/ui/tau/creating_animation_w.htm +++ b/org.tizen.guides/html/web/ui/tau/creating_animation_w.htm @@ -44,14 +44,14 @@

    You can create a simple application using TAU Animation. With the following example, you can learn how to import TAU Animation into your application and create a basic simple application with animation.

    Loading a TAU Animation

    -

    You can import the TAU Animation with HTML:

    +

    You can import the TAU Animation module with HTML:

     <head>
        <title>TAU Animation Sample</title>
        <script src="lib/tau/animation/tau.animation.min.js" type="text/javascript"></script>
     </head>
     
    -

    tau.animation is the namespace of the TAU Animation. You can call TAU Animation methods through this namespace.

    +

    tau.animation is the namespace of the TAU Animation module. You can call TAU Animation methods through this namespace.

    Note @@ -72,7 +72,7 @@ t('#redBox').tween('swing', 1000); t('#blueBox').tween({rotateZ: 120}, 1000).tween({translateX: 400}, 1000); -

    If you want to animate the HTML element directly, you can use mixin. You can animate any effect, transform, or CSS property. You can use the 'target' method. Like a CSS selector, '.' means class selector, '#' means ID selector. Also, a pure HTML element can be a parameter of the target method.

    +

    If you want to animate the HTML element directly, you can use mixin. You can animate any effect, transform, or CSS property. You can use the 'target' method. Like in CSS selectors, '.' is a class selector and '#' is an ID selector. Also, a pure HTML element can be a parameter of the target method.

    Available animation methods:

    • Predefined effects @@ -143,7 +143,7 @@ t('.box').tween({rotateZ: 120}, {duration: 1000, stagger: 200});
    -

    The following code snippet shows the full code for the first animation example described above.

    +

    The following example shows the full code for the first animation described above.

     <!DOCTYPE html>
     <html>
    diff --git a/org.tizen.guides/html/web/ui/tau/globalization_w.htm b/org.tizen.guides/html/web/ui/tau/globalization_w.htm
    index d4d7128..d87b555 100644
    --- a/org.tizen.guides/html/web/ui/tau/globalization_w.htm
    +++ b/org.tizen.guides/html/web/ui/tau/globalization_w.htm
    @@ -44,7 +44,7 @@
     

    Globalization

    -

    The TAU Globalize utility supports internationalization and localization. It wraps the Globalize functionality for easy access from Tizen Web applications, and it is extended to support the right-to-left (RTL) languages.

    +

    The TAU Globalize utility supports internationalization and localization. It wraps the Globalize functionality for easy access from Tizen Web applications, and it is extended to support right-to-left (RTL) languages.

    This feature is supported in mobile and wearable applications only.

    @@ -281,7 +281,7 @@ document.addEventListener('pageshow', function() {
  • formatMessage():

    This method supports custom locale data.

      -
    1. Create a directory for each locale that has localized content under the locales directory in the project root. The locale names are defined in the W3C IANA language subtag registry. +
    2. Create a directory for each locale that has localized content under the locales directory in the project root. The locale names are defined in the W3C IANA Language Subtag Registry.
       index.html
       locale
      diff --git a/org.tizen.guides/html/web/ui/tau/managing_page_w.htm b/org.tizen.guides/html/web/ui/tau/managing_page_w.htm
      index 582cd58..5886e42 100644
      --- a/org.tizen.guides/html/web/ui/tau/managing_page_w.htm
      +++ b/org.tizen.guides/html/web/ui/tau/managing_page_w.htm
      @@ -29,7 +29,7 @@
               
               

      Related Info

      @@ -47,7 +47,7 @@

      This feature is supported in mobile and wearable applications only.

      Page Structure

      -

      The page consist of:

      +

      A page consists of:

      • Header area

        Shows the user which page is currently open. The header can contain buttons, menus, and toolbars. The header is optional.

      • @@ -129,7 +129,7 @@
    -

    Creating Multiple Pages in One HTML Code

    +

    Creating Multiple Pages in One HTML File

    You can implement a template containing multiple page containers in the application's index.html file.

    @@ -175,7 +175,7 @@ </div> </div>
  • -

    With multiple pages in one HTML code, you can use only the ID of the page in the href attribute:

    +

    With multiple pages in one HTML file, you can use only the ID of the page in the href attribute:

     <div class="ui-page ui-page-active" id="first">
        <div class="ui-content">
    diff --git a/org.tizen.guides/html/web/ui/tau/tau_porting_w.htm b/org.tizen.guides/html/web/ui/tau/tau_porting_w.htm
    index e62f65b..6a00e4c 100644
    --- a/org.tizen.guides/html/web/ui/tau/tau_porting_w.htm
    +++ b/org.tizen.guides/html/web/ui/tau/tau_porting_w.htm
    @@ -681,7 +681,7 @@
     
     
     

    Event Handling

    -

    Some events are changed. The following examples illustrate how to handle events:

    +

    Some events have changed. The following examples illustrate how to handle events:

    • Swipe event

      In the previous version, the swipe event was triggered in every area in the page automatically, but since 2.4, for efficient trigger and handling, the swipe event is only triggered when the Gesture event is created.

      diff --git a/org.tizen.guides/html/web/w3c/device/vibration_w.htm b/org.tizen.guides/html/web/w3c/device/vibration_w.htm index be7c2bb..8c27a0d 100644 --- a/org.tizen.guides/html/web/w3c/device/vibration_w.htm +++ b/org.tizen.guides/html/web/w3c/device/vibration_w.htm @@ -41,7 +41,7 @@

      Vibration

      -

      To provide tactile feedback to the user or to interact with the user even when the device volume is low, you can make a Tizen device vibrate. The vibration provides better user experience and therefore improves the perception of your application.

      +

      To provide tactile feedback to the user or to interact with the user even when the device volume is low, you can make a Tizen device vibrate. The vibration can provide a better user experience and improve the perception of your application.

      This feature is supported in mobile and wearable applications only.

      diff --git a/org.tizen.guides/html/web/w3c/storage/file_w.htm b/org.tizen.guides/html/web/w3c/storage/file_w.htm index dfb741f..d88c22b 100644 --- a/org.tizen.guides/html/web/w3c/storage/file_w.htm +++ b/org.tizen.guides/html/web/w3c/storage/file_w.htm @@ -50,7 +50,7 @@

      File

      -

      Tizen enables you to access local storage to read file information. In mobile applications, you can also manipulate files by accessing sandboxed file systems.

      +

      You can access a local storage to read file information. In mobile applications, you can also manipulate files by accessing sandboxed file systems.

      This feature is supported in mobile and wearable applications only.

      diff --git a/org.tizen.guides/html/web/w3c/storage/indexdb_w.htm b/org.tizen.guides/html/web/w3c/storage/indexdb_w.htm index e089e76..0652a21 100644 --- a/org.tizen.guides/html/web/w3c/storage/indexdb_w.htm +++ b/org.tizen.guides/html/web/w3c/storage/indexdb_w.htm @@ -44,7 +44,7 @@

      Indexed Database

      -

      In HTML5, an indexed database is a local storage used to store and manipulate data in a client. You can implement effective searches using an index as a simple storage structure in key-value format. +

      In HTML5, an indexed database is a local storage used to store and manipulate key-value format data in a client. You can implement effective searches using an index, which is a specialized persistent key-value storage containing entries from the database based on specific property values.

      This feature is supported in mobile and wearable applications only.

      diff --git a/org.tizen.guides/html/web/w3c/storage/websql_w.htm b/org.tizen.guides/html/web/w3c/storage/websql_w.htm index 1362088..bd1730f 100644 --- a/org.tizen.guides/html/web/w3c/storage/websql_w.htm +++ b/org.tizen.guides/html/web/w3c/storage/websql_w.htm @@ -117,7 +117,7 @@ try {

      Executing SQL Statements Asynchronously

      -

      To provide users with SQL database features, you must learn to execute SQL statements asynchronously:

      +

      To execute SQL statements asynchronously:

      1. In the Web SQL Database API, each SQL statement must be executed under a transaction. To create a transaction, use either transaction() or readTransaction() method returned by the openDatabase() method:

        @@ -244,8 +244,7 @@ try {

        Executing SQL Statements Synchronously

        - -

        To provide users with SQL database features, you must learn to execute SQL statements synchronously:

        +

        To execute SQL statements synchronously:

        1. In the Web SQL Database API, each SQL statement must be executed under a transaction. To create a transaction, use either transaction() or readTransaction() method returned by the openDatabaseSync() method:

          diff --git a/org.tizen.guides/html/web/w3c/supplement/webgl_w.htm b/org.tizen.guides/html/web/w3c/supplement/webgl_w.htm index cdebc8f..0ef00f3 100644 --- a/org.tizen.guides/html/web/w3c/supplement/webgl_w.htm +++ b/org.tizen.guides/html/web/w3c/supplement/webgl_w.htm @@ -104,7 +104,7 @@ The vertex shader sets the final position of a vertex, and the fragment shader s

          Importing the WebGL™ Context

          -

          To enhance the user experience of your application with WebGL™ features, you must learn to import the WebGL™ context from the HTML5 <canvas> element:

          +

          To import the WebGL™ context from the HTML5 <canvas> element:

          1. Define the <canvas> element ID and set its width and height:

            @@ -154,7 +154,7 @@ The vertex shader sets the final position of a vertex, and the fragment shader s
             
              

            Initializing Programs and Shaders

            -

            To enhance the user experience of your application with WebGL™ features, you must learn to bind the shaders and GLSL ES in WebGL™ by using shaders and programs: +

            To bind the shaders and GLSL ES in WebGL™ by using shaders and programs:

            1. Define the vertex shader and fragment shader using the gl_Position and gl_FragColor variables of the OpenGL® ES Shading Language (GLSL ES):

              @@ -247,7 +247,7 @@ The vertex shader sets the final position of a vertex, and the fragment shader s

              Initializing Buffers

              -

              To enhance the user experience of your application with WebGL™ features, you must learn to create buffers, bind them, and store data in them: +

              To create buffers, bind them, and store data in them:

                @@ -298,7 +298,7 @@ The vertex shader sets the final position of a vertex, and the fragment shader s

                Drawing Shapes on the Screen

                -

                To enhance the user experience of your application with WebGL™ features, you must learn to display shapes on the screen using attribute array data and a drawing buffer: +

                To display shapes on the screen using attribute array data and a drawing buffer:

                  @@ -490,7 +490,7 @@ gl.drawArrays(gl. TRIANGLE_FAN, 0, 6);

                  Setting Colors

                  -

                  To enhance the user experience of your application with WebGL™ features, you must learn to set colors using attributes and a buffer:

                  +

                  To set colors using attributes and a buffer:

                  1. Define the vertex shader and fragment shader using the gl_Position and gl_FragColor variables of the OpenGL® ES Shading Language (GLSL ES):

                    @@ -571,7 +571,7 @@ gl.drawArrays(gl. TRIANGLE_FAN, 0, 6);

                    Setting Textures

                    -

                    To enhance the user experience of your application with WebGL™ features, you must learn to use a texture, which is an image applied to the surface:

                    +

                    To apply an image from a file to a surface as a texture:

                    1. Define the vertex shader and fragment shader using the gl_Position and gl_FragColor variables of the OpenGL® ES Shading Language (GLSL ES). In this example, the texture coordinate attribute is used instead of the vertex coordinate attribute.

                      @@ -606,7 +606,7 @@ gl.drawArrays(gl. TRIANGLE_FAN, 0, 6);
                      Note - The texture coordinates uses the s, t pair. + The texture coordinates use the s, t pair.
                    2. @@ -687,7 +687,7 @@ gl.drawArrays(gl. TRIANGLE_FAN, 0, 6);

                      Creating an Animation

                      -

                      To enhance the user experience of your application with WebGL™ features, you must learn to adjust and move object coordinates to create an animation:

                      +

                      To create an animation by adjusting and moving object coordinates:

                      1. Calculate the central point: @@ -769,7 +769,7 @@ gl.drawArrays(gl. TRIANGLE_FAN, 0, 6);

                        Creating a 3D Perspective

                        -

                        To enhance the user experience of your application with WebGL™ features, you must learn to create 3D perspective using the glMatrix library:

                        +

                        To create a 3D perspective, you can use the glMatrix library:

                        1. Set the vertex coordinate and color buffer values to draw 2 triangles:

                          @@ -914,7 +914,7 @@ gl.drawArrays(gl. TRIANGLE_FAN, 0, 6);

                          Using Touch Events

                          -

                          To enhance the user experience of your application with WebGL™ features, you must learn to apply a texture and 3D perspective with touch events using the glMatrix library. The following example demonstrates how to display and turn a dice on the screen based on touch events.

                          +

                          You can apply a texture and 3D perspective with touch events by using the glMatrix library. The following example demonstrates how to display and turn a dice on the screen based on touch events:

                          1. Define the vertex shader and fragment shader using the gl_Position and gl_FragColor variables of the OpenGL® ES Shading Language (GLSL ES):

                            @@ -1209,7 +1209,7 @@ gl.drawArrays(gl. TRIANGLE_FAN, 0, 6);

                            Using WebGL™ Frameworks

                            -

                            To enhance the user experience of your application with WebGL™ features, you must learn to use the three.js framework:

                            +

                            To use the three.js framework for your WebGL™ application:

                            1. Download the three.js library and include it in the HTML file:

                              @@ -1387,7 +1387,7 @@ gl.drawArrays(gl. TRIANGLE_FAN, 0, 6);
                            2. Add an animation:

                                   function animate() {
                              -        var speed= 0.2;
                              +        var speed = 0.2;
                                       var lastTime = 0;
                                       var angle = 0.0;
                               
                              diff --git a/org.tizen.guides/html/web/w3c/ui/animation_w.htm b/org.tizen.guides/html/web/w3c/ui/animation_w.htm
                              index 6ad4847..db03c02 100644
                              --- a/org.tizen.guides/html/web/w3c/ui/animation_w.htm
                              +++ b/org.tizen.guides/html/web/w3c/ui/animation_w.htm
                              @@ -186,7 +186,7 @@
                               
                               

                              Creating a Logo Animation

                              -

                              To enhance the user experience of your application, you must learn to create a logo animation, where element properties can be assigned and changed for each element and keyframe. The logo animation is similar to the animation that appears when a Tizen device (or the emulator) is switched on:

                              +

                              You can create an animation where element properties can be assigned and changed for each element and keyframe. The logo animation in the following example is similar to the animation that appears when a Tizen device (or the emulator) is switched on:

                              1. No elements are initially shown on the screen.
                              2. diff --git a/org.tizen.guides/html/web/w3c/ui/background_w.htm b/org.tizen.guides/html/web/w3c/ui/background_w.htm index ec3aace..5ac871e 100644 --- a/org.tizen.guides/html/web/w3c/ui/background_w.htm +++ b/org.tizen.guides/html/web/w3c/ui/background_w.htm @@ -125,7 +125,7 @@

                                Creating Backgrounds

                                -

                                To enhance the user experience of your application, you must learn to create a multilayer background with the parallax effect using the CSS box model. The background consists of 3 images on separate layers, and 2 of the layers can be moved over each other.

                                +

                                You can create a multilayer background with a parallax effect using the CSS box model. The background consists of 3 images on separate layers, and 2 of the layers can be moved over each other.

                                Figure: Background with the parallax effect

                                Background with the parallax effect

                                diff --git a/org.tizen.guides/html/web/w3c/ui/basic_ui_w.htm b/org.tizen.guides/html/web/w3c/ui/basic_ui_w.htm index fd54cf6..6a76555 100644 --- a/org.tizen.guides/html/web/w3c/ui/basic_ui_w.htm +++ b/org.tizen.guides/html/web/w3c/ui/basic_ui_w.htm @@ -73,7 +73,7 @@

                                Using Pseudo-element Selectors

                                -

                                To enhance the user experience of your application, you must learn how to use pseudo-element selectors:

                                +

                                To use pseudo-element selectors:

                                1. Use the pseudo-classes, such as :enabled and :disabled, to add different styles based on the state of the DOM elements:

                                  @@ -126,7 +126,7 @@ input: optional, textarea: optional {border: 1px solid #777}
                                   
                                   

                                  Using Box Model Properties

                                  -

                                  To enhance the user experience of your application, you must learn how to use box model properties:

                                  +

                                  To use the box model properties in your application:

                                  Note diff --git a/org.tizen.guides/html/web/w3c/ui/clipboard_mw.htm b/org.tizen.guides/html/web/w3c/ui/clipboard_mw.htm index 60d29db..99f53a1 100644 --- a/org.tizen.guides/html/web/w3c/ui/clipboard_mw.htm +++ b/org.tizen.guides/html/web/w3c/ui/clipboard_mw.htm @@ -61,7 +61,7 @@

                                  Copying Content

                                  -

                                  To enhance the user experience of your application with clipboard operations, you must learn to use the copy event:

                                  +

                                  To copy content using the copy event:

                                  1. Add an event listener to detect the copy event:
                                    @@ -101,7 +101,7 @@
                                     
                                      

                                    Cutting Content

                                    -

                                    To enhance the user experience of your application with clipboard operations, you must learn to use the cut event:

                                    +

                                    To cut content using the cut event:

                                    1. Add an event listener to detect the cut event:
                                      @@ -144,7 +144,7 @@
                                       
                                        

                                      Pasting Content

                                      -

                                      To enhance the user experience of your application with clipboard operations, you must learn to use the paste event:

                                      +

                                      To paste content using the paste event:

                                      1. Add an event listener to detect the paste event:
                                        @@ -178,7 +178,7 @@
                                         
                                          

                                        Copying and Pasting Content into an Editable Element

                                        -

                                        To enhance the user experience of your application with clipboard operations, you must learn to copy content and paste it in an editable HTML element:

                                        +

                                        To copy and paste content in an editable HTML element:

                                        1. Define the editable element into which copied data is to be pasted:

                                          diff --git a/org.tizen.guides/html/web/w3c/ui/flexible_w.htm b/org.tizen.guides/html/web/w3c/ui/flexible_w.htm index 16fae0e..e7dcfc7 100644 --- a/org.tizen.guides/html/web/w3c/ui/flexible_w.htm +++ b/org.tizen.guides/html/web/w3c/ui/flexible_w.htm @@ -58,7 +58,7 @@

                                          Flexible box layout

                                          Using the Flex Container

                                          -

                                          To enhance the user experience of your application, you must learn how to assign size and alignment to the flex container:

                                          +

                                          To assign size and alignment to a flex container:

                                          1. Assign the area (flex container) where the flexible box layout is applied by using the display: flex property: @@ -141,9 +141,9 @@
                                          2. flex_container_properties_6.html
    -

    Using the Flex Items

    +

    Using the Flex Items

    -

    To enhance the user experience of your application, you must learn how to assign size and alignment to the flex items:

    +

    To assign size and alignment to the flex items in a flex container:

    1. Assign the area (flex container) where the flexible box layout is applied, and define the flex items for it: @@ -189,7 +189,7 @@

      Creating a Flexible Layout with CSS3

      -

      To enhance the user experience of your application, you must learn how to create flexible box layout:

      +

      To create a flexible box layout with CSS3:

      1. Define the HTML content for the flexible layout. In this example, create 2 articles areas, 1 for a text list and 1 for an icon list:
        diff --git a/org.tizen.guides/html/web/w3c/ui/font_w.htm b/org.tizen.guides/html/web/w3c/ui/font_w.htm
        index 037a91a..54ece15 100644
        --- a/org.tizen.guides/html/web/w3c/ui/font_w.htm
        +++ b/org.tizen.guides/html/web/w3c/ui/font_w.htm
        @@ -54,7 +54,7 @@
         
         

        Manipulating Fonts

        -

        To enhance the user experience of your application, you must learn to handle fonts using CSS font properties:

        +

        To manipulate fonts using CSS font properties:

        1. Define the font-style property within a <style> element in the <head> section of the Web page to apply different font styles:

          diff --git a/org.tizen.guides/html/web/w3c/ui/media_query_w.htm b/org.tizen.guides/html/web/w3c/ui/media_query_w.htm index 74a1fcc..59e1362 100644 --- a/org.tizen.guides/html/web/w3c/ui/media_query_w.htm +++ b/org.tizen.guides/html/web/w3c/ui/media_query_w.htm @@ -213,7 +213,7 @@ body {background-color: tomato}

          Creating a Liquid Layout

          -

          To enhance the user experience of your application, you must learn to define media queries to determine the styles to be used in the Web document. This example creates a simple Web document with a liquid layout that organically changes according to the device resolution to show the optimized layout on both portrait and landscape modes.

          +

          You can use media queries to determine the styles to be used in a Web document. The following example creates a simple Web document with a liquid layout that organically changes according to the device resolution to show an optimized layout on both portrait and landscape modes:

            diff --git a/org.tizen.guides/html/web/w3c/ui/multi_mw.htm b/org.tizen.guides/html/web/w3c/ui/multi_mw.htm index a36213e..9dec3a7 100644 --- a/org.tizen.guides/html/web/w3c/ui/multi_mw.htm +++ b/org.tizen.guides/html/web/w3c/ui/multi_mw.htm @@ -62,7 +62,7 @@

            Setting the Column Number and Width

            When the layout is set to a constant number of columns using the column-count (or -webkit-column-count) property, the column width is set to fill the available horizontal space.

            -

            In the following code snippet and figure, the column number is set to 4. As a result, on a 480 x 800 display (shown at the top), the column width is 116 px, whereas on a 720 x 1280 display (shown at the bottom), the column with is 143 px.

            +

            In the following code snippet and figure, the column number is set to 4. As a result, on a 480 x 800 display (shown at the top), the column width is 116 px, whereas on a 720 x 1280 display (shown at the bottom), the column width is 143 px.

            The following code snippet demonstrates how to use the column-count property. For a complete source code, see multi_column_column_count/renamed_index.html.

             article {
            @@ -171,8 +171,7 @@ article.lower section {
             

            Column break

            Creating a Basic Layout

            - -

            To enhance the user experience of your application by providing a consistent behavior across a wide range of displays with different resolution and orientation, you must learn to create a basic layout using CSS:

            +

            To create a basic layout for your application using CSS, providing consistent behavior across a wide range of displays with different resolutions and orientations:

            1. @@ -315,9 +314,10 @@ img {
            2. Tizen_WhiteFold_4.png
            3. -

              Creating a Layout with Dynamic Content

              +

              Creating a Layout with Dynamic Content

              + +

              To use CSS to create a layout that provides varying amounts of content, providing consistent behavior across a wide range of displays with different resolutions and orientations:

              -

              To enhance the user experience of your application by providing a consistent behavior across a wide range of displays with different resolution and orientation, you must learn to create a layout displaying a varying amount of content using CSS:

              1. Create the HTML layout. The article element displays the columns, and the nav element contains buttons to add and remove content in the columns.

                diff --git a/org.tizen.guides/html/web/w3c/ui/selector_w.htm b/org.tizen.guides/html/web/w3c/ui/selector_w.htm index af6b033..32417e0 100644 --- a/org.tizen.guides/html/web/w3c/ui/selector_w.htm +++ b/org.tizen.guides/html/web/w3c/ui/selector_w.htm @@ -61,7 +61,7 @@

                You can also create an accordion menu.

                Selecting a Single Node

                -

                To enhance the user experience of your application, you must learn to use selectors to handle page elements, and to select a single node:

                +

                To use selectors for handling page elements and selecting a single node:

                1. To select the first matching element found in the child nodes, use the querySelector() method with CSS selectors. You get the same result as when using the getElementById(), getElementsByTagName(), and getElementsByClassName() methods.
                  @@ -97,8 +97,10 @@ var targetObj = obj.querySelector('tbody > tr:nth-child(2) :last-child');
                   	
                2. accordion.html
                3. -

                  Selecting Multiple Nodes

                  -

                  To enhance the user experience of your application, you must learn to use selectors to handle page elements, and to select multiple nodes in a node list:

                  +

                  Selecting Multiple Nodes

                  + +

                  To use selectors for handling page elements and selecting multiple nodes in a node list:

                  +
                  1. Select an element in the node list using the querySelector() method:
                    @@ -112,7 +114,7 @@ var obj = document.querySelector('table:nth-child(2)');
                     var targetObj = obj.querySelectorAll('thead th, tbody td');
                     var i = targetObj.length;
                     
                    -

                    The querySelectorAll() method returns an array containing all of the matching element nodes within the subtrees of the context node, in the document order, and saves the elements in a node list. If there are no matching nodes, the method returns an empty array. The query above selects the <th> elements in the table head and the <td> elements in the table body.

                    +

                    The querySelectorAll() method returns an array containing all matching element nodes within the subtrees of the context node, in the document order, and saves the elements in a node list. If there are no matching nodes, the method returns an empty array. The query above selects the <th> elements in the table head and the <td> elements in the table body.

                  2. Apply a defined style to all elements stored in the targetObj node list:
                    @@ -131,10 +133,11 @@ while (0 < i) {
                     	
                  3. accordion.html
                  4. -

                    Creating an Accordion Menu

                    +

                    Creating an Accordion Menu

                    + +

                    You can retrieve element nodes from the DOM tree and create a simple accordion menu.

                    -

                    To enhance the user experience of your application, you must learn to retrieve element nodes from the DOM tree to create a simple accordion menu.

                    -

                    The accordion menu is created using the CSS3 Basic User Interface Module Level 3 API (in mobile or wearable applications). When a title is touched, the relevant content is shown, and other content is hidden.

                    +

                    The accordion menu is created using the CSS3 Basic User Interface Module Level 3 API (in mobile, wearable, and TV applications). When a title is touched, the relevant content is shown, and other content is hidden.

                    1. Create the HTML layout:
                      diff --git a/org.tizen.guides/html/web/w3c/ui/text_module_w.htm b/org.tizen.guides/html/web/w3c/ui/text_module_w.htm
                      index b36cef6..41ceb60 100644
                      --- a/org.tizen.guides/html/web/w3c/ui/text_module_w.htm
                      +++ b/org.tizen.guides/html/web/w3c/ui/text_module_w.htm
                      @@ -54,7 +54,7 @@
                       
                       

                      Manipulating Text

                      -

                      To enhance the user experience of your application, you must learn to handle line breaking, justification, alignment, white space handling, and text transformations using CSS text properties:

                      +

                      To use CSS text properties to manipulate line breaking, justification, alignment, white space handling, and text transformations:

                      1. Define the text-transform property within a <style> element in the <head> section of the Web page to control the text capitalization: diff --git a/org.tizen.guides/html/web/w3c/ui/transform_w.htm b/org.tizen.guides/html/web/w3c/ui/transform_w.htm index 8af9cea..82435fb 100644 --- a/org.tizen.guides/html/web/w3c/ui/transform_w.htm +++ b/org.tizen.guides/html/web/w3c/ui/transform_w.htm @@ -85,7 +85,7 @@
                      2. perspective-origin

                        This property defines the location facing the element.

                      3. backface-visibility -

                        This property defines whether the backface of the transformed element is expressed.

                      4. +

                        This property defines whether the backside of the transformed element is expressed.

                        @@ -251,7 +251,7 @@
                         
                         

                        Creating an Animation with Transforms

                        -

                        To enhance the user experience of your application, you must learn to use transforms with animations. This example uses the animation from the Creating a Logo Animation use case as a basis, and adds a more diverse visual effect to it with the transform property. In the modified animation:

                        +

                        You can create an animation with transforms. The following example uses the animation from the Creating a Logo Animation use case as a basis, and adds a more diverse visual effect to it with the transform property. In the modified animation:

                        • As in the original animation, no elements are initially shown on the screen.
                        • @@ -422,9 +422,7 @@

                          Creating Fade Animation Effects

                          - -

                          To enhance the user experience of your application, you must learn to use fade animation effects.

                          -

                          The modal layer pop-up can be used to, for example, show enlarged thumbnail images or notice messages. The modal layer pop-up has the following basic properties:

                          +

                          You can create fade animation effects using a modal layer pop-up. The modal layer pop-up can be used to, for example, show enlarged thumbnail images or notice messages. The modal layer pop-up has the following basic properties:

                          • If an event is fired, it gradually becomes visible. This is known as the Fade In effect.
                          • The existing background is covered with a translucent layer to make the user focus on the pop-up.
                          • @@ -571,17 +569,17 @@ function showModalPopup(url) {

                            Using Hardware Acceleration

                            The rendering performance of a Web application depends on both the Tizen platform and application design.

                            -

                            In hardware acceleration, GPU is used to perform a method faster than is possible if the application is running on the CPU. It enhances the rendering performance in the dynamic objects used in Web applications.

                            +

                            With hardware acceleration, the GPU is used to perform a method faster than is possible if the application is running on the CPU. It enhances the rendering performance in the dynamic objects used in Web applications.

                            Using CSS Transition and 3D Transform

                            To improve the rendering performance, separate moving elements to independent layers as much as possible. You can use CSS transition with the -webkit-transition CSS attribute, or 3D transform with the -webkit-transform attribute. For the best performance, set the -webkit-transform attribute to the 3D type.

                            -

                            In all the following examples, a blue box moves from top left to bottom right for a second.

                            +

                            In the following examples, a blue box moves from the top left diagonally downward for 1 second.

                            Figure: Blue box

                            Blue box

                            • Use CPU painting: -

                              JavaScript performs CPU painting for a moving element for each frame at 16 ms interval using the setTimeout() method over the changing top-left coordinate. This approach does not use hardware acceleration, but only running on the CPU.

                              +

                              JavaScript performs CPU painting for a moving element for each frame at 16 ms interval using the setTimeout() method over the changing top-left coordinate. This approach does not use hardware acceleration, only the CPU.

                              1. Construct the blue box and set its position on the screen:
                                diff --git a/org.tizen.guides/html/web/w3c/ui/transition_w.htm b/org.tizen.guides/html/web/w3c/ui/transition_w.htm
                                index a103e50..4917eb1 100644
                                --- a/org.tizen.guides/html/web/w3c/ui/transition_w.htm
                                +++ b/org.tizen.guides/html/web/w3c/ui/transition_w.htm
                                @@ -124,12 +124,12 @@
                                 </style>
                                 
                                -

                                The transition property connects movement more naturally than the more generally used the pseudo classes, such as :hover or :active. The smooth effect can be achieved more conveniently and easily with the transition property than with JavaScript or Flash, and the transition property also supports the browser side to provide excellent performance.

                                +

                                The transition property connects movement more naturally than the more generally used pseudo classes, such as :hover or :active. The smooth effect can be achieved more conveniently and easily with the transition property than with JavaScript or Flash, and the transition property also supports the browser side to provide excellent performance.

                                Modifying Element Properties

                                -

                                To enhance the user experience of your application, you must learn to use transitions to change element property values naturally. This example uses a partial section of the http://tizen.org Web site, where the current "UPCOMING EVENTS" area only has the text-decoration: underline property in a mouseover state (the text gets underlined when the mouse hovers over it). To improve the effects, the example adds various transitions properties in this area.

                                +

                                You can use transitions to change element property values naturally. The following example uses a partial section of the http://tizen.org Web site, where the current "UPCOMING EVENTS" area only has the text-decoration: underline property in a mouseover state (the text gets underlined when the mouse hovers over it). To improve the effects, the example adds various transitions properties in this area.

                                Figure: Tizen site section to be transitioned

                                @@ -240,13 +240,13 @@

                                Using CSS Transition and 3D Transform

                                To improve the rendering performance, separate moving elements to independent layers as much as possible. You can use CSS transition with the -webkit-transition CSS attribute, or 3D transform with the -webkit-transform attribute. For the best performance, set the -webkit-transform attribute to the 3D type.

                                -

                                In all the following examples, a blue box moves from top left to bottom right for a second.

                                +

                                In the following examples, a blue box moves from the top left diagonally downward for 1 second.

                                Figure: Blue box

                                Blue box

                                • Use CPU painting: -

                                  JavaScript performs CPU painting for a moving element for each frame at 16 ms interval using the setTimeout() method over the changing top-left coordinate. This approach does not use hardware acceleration, but only running on the CPU.

                                  +

                                  JavaScript performs CPU painting for a moving element for each frame at 16 ms interval using the setTimeout() method over the changing top-left coordinate. This approach does not use hardware acceleration, only the CPU.

                                  1. Construct the blue box and set its position on the screen:
                                    diff --git a/org.tizen.guides/html/web/w3c/ui/ui_guide_w.htm b/org.tizen.guides/html/web/w3c/ui/ui_guide_w.htm
                                    index 4987c33..9f0845a 100644
                                    --- a/org.tizen.guides/html/web/w3c/ui/ui_guide_w.htm
                                    +++ b/org.tizen.guides/html/web/w3c/ui/ui_guide_w.htm
                                    @@ -122,7 +122,7 @@
                                     
                                  2. Designing for multiple screens

                                    Tizen supports various device types with several different screen sizes.

                                    -

                                    To provide optimal user experiences, it is important to design your application to support different screen sizes. In addition to different devices, you must also consider system configuration changes, such as the default home screen layout and system fonts after OS upgrades, since they can change the size of the viewable content screen. Such changes affect the application layout, and can lead to an undesirable UI design layout. Use the following topics to design your application to be highly flexible and adaptive against these possibilities.

                                    +

                                    To provide an optimal user experience, it is important to design your application to support different screen sizes. In addition to different devices, you must also consider system configuration changes, such as the default home screen layout and system fonts after OS upgrades, since they can change the size of the viewable content screen. Such changes affect the application layout, and can lead to an undesirable UI design layout. Use the following topics to design your application to be highly flexible and adaptive against these possibilities.

                                    • Multiple UI Layouts in wearable applications only

                                      Allows you to design your application layout so that your application can run on multiple Tizen devices.

                                    • diff --git a/org.tizen.guides/html/web/w3c/ui/ui_layout_ww.htm b/org.tizen.guides/html/web/w3c/ui/ui_layout_ww.htm index ca5ea49..2369096 100644 --- a/org.tizen.guides/html/web/w3c/ui/ui_layout_ww.htm +++ b/org.tizen.guides/html/web/w3c/ui/ui_layout_ww.htm @@ -63,7 +63,7 @@

                                      Viewport and Other Meta Tags

                                      -

                                      The viewport is a screen area that the Web engine displays in the UI and, in the Web world, the viewport meta tag is used to inform the Web engine that this content is written for a specific form factor, such as device width. The viewport meta tag was introduced by Apple to fill the screen resolution gap between initial Smartphone (for example, 320 px) and PC (for example, 980 px). Basically, the viewport meta tag helps the Web engine to determine the scale factor for the content on the current device.

                                      +

                                      The viewport is a screen area that the Web engine displays in the UI and, in the Web world, the viewport meta tag is used to inform the Web engine that this content is written for a specific form factor, such as device width. The viewport meta tag was introduced by Apple to fill the screen resolution gap between initial Smart phone (for example, 320 px) and PC (for example, 980 px). Basically, the viewport meta tag helps the Web engine to determine the scale factor for the content on the current device.

                                      To use the tag in an HTML file, set its name and content:

                                      diff --git a/org.tizen.guides/html/web/w3c/ui/woff_w.htm b/org.tizen.guides/html/web/w3c/ui/woff_w.htm
                                      index d33e1a1..ae2d288 100644
                                      --- a/org.tizen.guides/html/web/w3c/ui/woff_w.htm
                                      +++ b/org.tizen.guides/html/web/w3c/ui/woff_w.htm
                                      @@ -54,7 +54,7 @@
                                       
                                       

                                      Using the WOFF File Format

                                      -

                                      To enhance the user experience of your application, you must learn to use the WOFF (Web Open Font Format) file format 1.0, which is a W3C standard font packaging format used in Web pages:

                                      +

                                      To use the WOFF (Web Open Font Format) file format, which is a W3C standard font packaging format used in Web pages:

                                      1. Download and use fonts installed on the Web server by creating @font-face rules. Within the rules, you can define the following properties: diff --git a/org.tizen.guides/html/web/w3c/useful/performance_w.htm b/org.tizen.guides/html/web/w3c/useful/performance_w.htm index 05d5ad9..00fc972 100644 --- a/org.tizen.guides/html/web/w3c/useful/performance_w.htm +++ b/org.tizen.guides/html/web/w3c/useful/performance_w.htm @@ -165,7 +165,7 @@ delete myApp.prop; Removing an unused DOM element
                                        -var el= $('#myelem');
                                        +var el = $('#myelem');
                                         el.parentNode.removeChild(el);