http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/5ad93d20/www/docs/es/7.x/plugin_ref/spec.md ---------------------------------------------------------------------- diff --git a/www/docs/es/7.x/plugin_ref/spec.md b/www/docs/es/7.x/plugin_ref/spec.md new file mode 100644 index 0000000..9fd5bc5 --- /dev/null +++ b/www/docs/es/7.x/plugin_ref/spec.md @@ -0,0 +1,541 @@ +--- +license: > + Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +title: Especificación de plugin +toc_title: Plugin.xml +--- + +# Especificación de plugin + +El `plugin.xml` archivo es un documento XML en el `plugins` espacio de nombres: `http://apache.org/cordova/ns/plugins/1.0` . Contiene un alto nivel `plugin` elemento que define el plugin y niños que definen la estructura del plugin. + +Un elemento de plugin de muestra: + + <?xml version="1.0" encoding="UTF-8"?> + <plugin xmlns="http://apache.org/cordova/ns/plugins/1.0"; + xmlns:android="http://schemas.android.com/apk/res/android"; + id="com.alunny.foo" + version="1.0.2"> + + +## *plugin* Elemento + +El `plugin` es elemento superior del manifiesto del plugin. Cuenta con los siguientes atributos: + +* `xmlns`(obligatorio): el espacio de nombres del plugin, `http://apache.org/cordova/ns/plugins/1.0` . Si el documento contiene XML de otros espacios de nombres, como las etiquetas que se añade a la `AndroidManifest.xml` archivo, esos espacios de nombres deben incluirse también en el elemento de nivel superior. + +* `id`(requerido): un revés-dominio estilo identificador para el plugin, tales como`com.alunny.foo` + +* `version`(requerido): un número de versión para el plugin, que coincide con la siguiente expresión regular estilo mayor-menor-patch: + + ^\d+[.]\d+[.]\d+$ + + +## Elementos *motores* y *motor* + +Los elementos secundarios de la `<engines>` elemento especificar las versiones de los marcos basados en Apache Cordova que este plugin soporta. Un ejemplo: + + <engines> + <engine name="cordova" version="1.7.0" /> + <engine name="cordova" version="1.8.1" /> + <engine name="worklight" version="1.0.0" platform="android" scriptSrc="worklight_version"/> + </engines> + + +Similar a la `<plugin>` del elemento `version` atributo, la cadena de versión especificada debe coincidir con una cadena de mayor-menor-patch conforme a la expresión regular: + + ^\d+[.]\d+[.]\d+$ + + +Elementos del motor también pueden especificar confuso acerca de los partidos para evitar la repetición y para reducir el mantenimiento cuando se actualiza la plataforma subyacente. Herramientas deben soportar un peso mÃnimo de `>` , `>=` , `<` y `<=` , por ejemplo: + + <engines> + <engine name="cordova" version=">=1.7.0" /> + <engine name="cordova" version="<1.8.1" /> + </engines> + + +El `<engine>` etiquetas también cuenta con soporte por defecto para todas las plataformas principales Cordova existe en. Especificar el `cordova` etiqueta motor significa que todas las versiones de Cordova en cualquier plataforma deben satisfacer el atributo de versión de motor. También puede enumerar sus versiones y plataformas especÃficas con el fin de reemplazar el catch-all `cordova` motor: + + <engines> + <engine name="cordova" version=">=1.7.0" /> + <engine name="cordova-android" version=">=1.8.0" /> + <engine name="cordova-ios" version=">=1.7.1" /> + </engines> + + +Aquà está una lista de la por defecto los motores que la `<engine>` soporta la etiqueta: + +* `cordova` +* `cordova-plugman` +* `cordova-amazon-fireos` +* `cordova-android` +* `cordova-ios` +* `cordova-blackberry10` +* `cordova-wp8` +* `cordova-windows8` +* `android-sdk` // returns the highest Android api level installed +* `apple-xcode` // returns the xcode version +* `apple-ios` // returns the highest iOS version installed +* `apple-osx` // returns the OSX version +* `blackberry-ndk` // returns the native blackberry SDK version + +Especificar Marcos personalizados basados en Apache Cordova deben aparecer bajo la etiqueta de motor asÃ: + + <engines> + <engine name="my_custom_framework" version="1.0.0" platform="android" scriptSrc="path_to_my_custom_framework_version"/> + <engine name="another_framework" version=">0.2.0" platform="ios|android" scriptSrc="path_to_another_framework_version"/> + <engine name="even_more_framework" version=">=2.2.0" platform="*" scriptSrc="path_to_even_more_framework_version"/> + </engines> + + +Un marco personalizado basado en Apache Cordova exige que un elemento motor incluye los siguientes atributos: `name` , `version` , `scriptSrc` , y`platform`. + +* `name`(requerido): un nombre legible para su marco personalizado. + +* `version`(obligatorio): la versión de que el marco debe tener para instalar. + +* `scriptSrc`(requerido): el archivo de comandos que dice plugman qué versión del marco personalizado. Idealmente, este archivo debe estar dentro del directorio de nivel superior de su directorio. + +* `platform`(requerido): las plataformas que soporta su marco. Usted puede utilizar el comodÃn `*` decir compatibles para todas las plataformas, especificar múltiples con un caracter como `android|ios|blackberry10` o simplemente una sola plataforma como`android`. + +plugman se anula con un código distinto de cero para cualquier plugin cuyo objetivo proyecto no cumple con las limitaciones del motor. + +Si no `<engine>` etiquetas se especifican, plugman intenta instalar en el directorio del proyecto especificado cordova ciegamente. + +## *nombre* Elemento + +Un nombre legible para el plugin, cuyo contenido de texto contiene el nombre del plugin. Por ejemplo: + + <name>Foo</name> + + +Este elemento no es (todavÃa) localización de la manija. + +## *Descripción* Elemento + +Una descripción legible para el plugin. El contenido del texto del elemento contiene la descripción del plugin. Un ejemplo: + + <description>Foo plugin description</description> + + +Este elemento no es (todavÃa) localización de la manija. + +## *autor* Elemento + +Nombre autor del plugin. El contenido del texto del elemento contiene el nombre del autor del plugin. Un ejemplo: + + <author>Foo plugin description</author> + + +## *palabras clave* Elemento + +Palabras clave plugin. El contenido del texto del elemento contiene palabras clave separadas por comas para describir el plugin. Un ejemplo: + + <keywords>foo,bar</keywords> + + +## *licencia* Elemento + +Licencia de plugin. El contenido del texto del elemento contiene la licencia del plugin. Un ejemplo: + + <license>Apache 2.0 License</license> + + +## *activo* Elemento + +Uno o más elementos listado los archivos o directorios que se copiarán en una aplicación Cordova `www` Directorio. Ejemplos: + + <!-- a single file, to be copied in the root directory --> + <asset src="www/foo.js" target="foo.js" /> + <!-- a directory, also to be copied in the root directory --> + <asset src="www/foo" target="foo" /> + + +Todos `<asset>` etiquetas requieren ambos `src` y `target` atributos. Sólo web plugins contiene principalmente `<asset>` elementos. Cualquier `<asset>` elementos que están anidados dentro de `<platform>` elementos especifican activos especÃficos a una plataforma web, como se describe a continuación. Los atributos incluyen: + +* `src`(requerido): donde se encuentra el archivo o directorio en el paquete del plugin, relativa a la `plugin.xml` documento. Si un archivo existe en la especificada `src` ubicación, plugman se detiene y revierte el proceso de instalación, emite una notificación sobre el conflicto y sale con un código distinto de cero. + +* `target` (required): + + Donde el fichero o el directorio debe estar ubicado en la aplicación de Cordova, relativa a la `www` directorio. Activos pueden ser dirigidas a subdirectorios, por ejemplo: + + <asset src="www/new-foo.js" target="js/experimental/foo.js" /> + + + crea la `js/experimental` directorio dentro de la `www` directorio, a menos que ya presente, entonces copias el `new-foo.js` archivo y cambia el nombre de lo `foo.js` . Si ya existe un archivo en la ubicación de destino, plugman se detiene y revierte el proceso de instalación, emite una notificación sobre el conflicto y sale con un código distinto de cero. + +## *JS-módulo* Elemento + +La mayorÃa de plugins incluyen uno o más archivos JavaScript. Cada `<js-module>` tag corresponde a un archivo JavaScript y evita que los usuarios del plugin tener que añadir un `<script>` etiqueta para cada archivo. Mientras que `<asset>` etiquetas simplemente copien un archivo desde el subdirectorio plugin en `www` , `<js-module>` etiquetas son mucho más sofisticados. Se parecen a esto: + + <js-module src="socket.js" name="Socket"> + <clobbers target="chrome.socket" /> + </js-module> + + +Al instalar un plugin con el ejemplo anterior, `socket.js` se copia a `www/plugins/my.plugin.id/socket.js` y se agrega como una entrada a `www/cordova_plugins.js` . En el tiempo de carga, el código `cordova.js` XHR se utiliza para leer cada archivo e inyectar un `<script>` tag en HTML. Agrega una asignación para aplastar o combinar según sea apropiado, como se describe a continuación. + +*No* envuelva el archivo con `cordova.define` , como se añade automáticamente. El módulo está envuelto en un cierre, con `module` , `exports` , y `require` en su alcance, como es normal para los módulos de AMD. + +Detalles para el `<js-module>` etiqueta: + +* El `src` hace referencia a un archivo en el directorio relativo a la `plugin.xml` archivo. + +* El `name` proporciona la última parte del nombre del módulo. Generalmente puede ser lo que quieras, y sólo importa si desea utilizar `cordova.require` para importar otras partes de tus plugins en tu código JavaScript. El nombre del módulo para un `<js-module>` es su plugin `id` seguido por el valor de `name` . Para el ejemplo anterior, con un `id` de `chrome.socket` , el nombre del módulo es`chrome.socket.Socket`. + +* Se permiten tres etiquetas en `<js-module>` : + + * `<clobbers target="some.value"/>`indica que el `module.exports` se inserta en la `window` de objetos como `window.some.value` . Usted puede tener tantos `<clobbers>` como usted tiene gusto. Cualquier objeto no está disponible en `window` es creado. + + * `<merges target="some.value"/>`indica que el módulo debe fusionarse con cualquier valor existente en `window.some.value` . Si ya existe alguna clave, versión del módulo reemplaza el original. Usted puede tener tantos `<merges>` como usted tiene gusto. Cualquier objeto no está disponible en `window` es creado. + + * `<runs/>`significa que el código debe especificarse con `cordova.require` , pero no instalado en el `window` objeto. Esto es útil al inicializar el módulo, adjuntar controladores de eventos o de lo contrario. Sólo puede tener hasta una `<runs/>` etiqueta. Tenga en cuenta que incluye un `<runs/>` con `<clobbers/>` o `<merges/>` es redundante, puesto que también `cordova.require` su módulo. + + * Un vacÃo `<js-module>` todavÃa las cargas y se puede acceder en otros módulos a través de`cordova.require`. + +Si `src` no se resuelve en un archivo existente, plugman se detiene y revierte la instalación, emite una notificación del problema y sale con un código distinto de cero. + +Anidación `<js-module>` elementos dentro de `<platform>` declara enlaces especÃficos a una plataforma JavaScript módulo. + +## *dependencia* Elemento + +El `<dependency>` etiqueta le permite especificar otros plugins de los que depende el plugin actual. Mientras que las versiones futuras accederán a ellos desde los repositorios de plugin, en el corto plazo plugins se hace directamente referencia como URL por `<dependency>` etiquetas. Ellos están formateados como sigue: + + <dependency id="com.plugin.id" url="https://github.com/myuser/someplugin"; commit="428931ada3891801" subdir="some/path/here" /> + + +* `id`: proporciona el ID del plugin. Debe ser único en el mundo y expresa en estilo de dominio reverso. Mientras que en la actualidad ninguna de estas restricciones se aplica, puede ser en el futuro. + +* `url`: Una dirección URL para el plugin. Esto debe hacer referencia un repositorio git, que plugman los intentos de clonar. + +* `commit`: Se trata de cualquier referencia de git entendido por `git checkout` : nombre de una rama o etiqueta (por ejemplo, `master` , `0.3.1` ), o una confirmación hash (por ejemplo,`975ddb228af811dd8bb37ed1dfd092a3d05295f9`). + +* `subdir`: Especifica que la dependencia de destino plugin existe como un subdirectorio del repositorio git. Esto es útil porque permite que el repositorio que contiene varios plugins relacionados, cada uno especificado individualmente. + +En el futuro, se introducirán las limitaciones de la versión y existirá un repositorio plugin para buscar por nombre en lugar de URLs explÃcitas de apoyo. + +### Dependencia relativa caminos + +Si establece la `url` de un `<dependency>` la etiqueta para `"."` y proporcionar una `subdir` , se instala el plugin dependiente del mismo local o remoto CVS como el plugin de padres que especifica la `<dependency>` etiqueta. + +Tenga en cuenta que el `subdir` siempre especifica una ruta relativa a la *raÃz* del repositorio git, no el plugin de padres. Esto es cierto incluso si ha instalado el plugin con una ruta local directamente a él. Plugman encuentra la raÃz del repositorio git y luego encuentra el otro plugin de allÃ. + +## *plataforma* Elemento + +El `<platform>` etiqueta identifica las plataformas que han asociado código nativo o requerir modificaciones en sus archivos de configuración. Herramientas utilizando esta especificación pueden identificar las plataformas soportadas e instalar el código en los proyectos de Córdoba. + +Plugins sin `<platform>` etiquetas se asumen para ser sólo de JavaScript y por lo tanto, instalable en cualquier y todas las plataformas. + +Una etiqueta de plataforma de muestra: + + <platform name="android"> + <!-- android-specific elements --> + </platform> + <platform name="ios"> + <!-- ios-specific elements --> + </platform> + + +La necesaria `name` atributo identifica una plataforma como apoyo, asociando los niños del elemento con esa plataforma. + +Nombres de la plataforma deben estar en minúsculas. Nombres de plataforma, como arbitrariamente elegidos, se enumeran: + +* Amazonas-fireos +* Android +* blackberry10 +* iOS +* wp8 +* windows8 + +## *archivo de código fuente* Elemento + +El `<source-file>` elemento identifica código ejecutable que debe instalarse en un proyecto. Ejemplos: + + <!-- android --> + <source-file src="src/android/Foo.java" + target-dir="src/com/alunny/foo" /> + <!-- ios --> + <source-file src="src/ios/CDVFoo.m" /> + <source-file src="src/ios/someLib.a" framework="true" /> + <source-file src="src/ios/someLib.a" compiler-flags="-fno-objc-arc" /> + + +Soporta los siguientes atributos: + +* `src`(requerido): Ubicación del archivo relativa a `plugin.xml` . Si el `src` no se encuentra archivo, plugman se detiene y revierte la instalación, emite una notificación sobre el problema y sale con un código distinto de cero. + +* `target-dir`: Un directorio en el que deben copiarse los archivos, relativo a la raÃz del proyecto Córdoba. En la práctica, esto es muy importante para las plataformas basadas en Java, donde un archivo en el `com.alunny.foo` paquete estará situado en la `com/alunny/foo` directorio. Para plataformas donde el directorio de origen no es importante, debe omitirse este atributo. + + Como con los activos, si la `target` de un `source-file` sobrescribir un archivo existente, plugman se detiene y revierte la instalación, emite una notificación sobre el problema y sale con un código distinto de cero. + +* `framework`(sólo en iOS): Si a `true` , también agrega el archivo especificado como un marco para el proyecto. + +* `compiler-flags`(sólo en iOS): si sistema, asigna los parámetros de compilador especificado para el archivo de origen en particular. + +## *archivo de configuración* Elemento + +Identifica un archivo de configuración basado en XML para ser modificado, donde en ese documento la modificación debe ocurrir, y qué deberÃa ser modificado. + +Dos tipos de archivos que han sido probados para la modificación de este elemento son `xml` y `plist` archivos. + +El `config-file` elemento sólo permite añadir nuevos niños a un árbol de documentos XML. Los niños son literales XML que se insertará en el documento de destino. + +Ejemplo de XML: + + <config-file target="AndroidManifest.xml" parent="/manifest/application"> + <activity android:name="com.foo.Foo" android:label="@string/app_name"> + <intent-filter> + </intent-filter> + </activity> + </config-file> + + +Ejemplo de `plist` : + + <config-file target="*-Info.plist" parent="CFBundleURLTypes"> + <array> + <dict> + <key>PackageName</key> + <string>$PACKAGE_NAME</string> + </dict> + </array> + </config-file> + + +Soporta los siguientes atributos: + +* `target`: + + El archivo a modificar y la ruta de acceso relativa a la raÃz del proyecto Córdoba. + + El destino puede incluir comodines ( `*` ) elementos. En este caso, plugman recursivamente busca a través de la estructura de directorios del proyecto y utiliza al primer partido. + + En iOS, la ubicación de los archivos de configuración en relación con la raÃz del directorio del proyecto no se conoce, asà que especifica un objetivo de `config.xml` decide`cordova-ios-project/MyAppName/config.xml`. + + Si el archivo especificado no existe, la herramienta pasa por alto el cambio en la configuración y continúa la instalación. + +* `parent`: Un selector XPath hacen referencia a los padres de los elementos a añadir al archivo config. Si utilizas selectores absolutos, puede utilizar un comodÃn ( `*` ) para especificar el elemento raÃz, por ejemplo,`/*/plugins`. + + Para `plist` archivos, el `parent` determina bajo qué clave primaria debe insertarse el XML especificado. + + Si el selector no resuelve a un niño de documento especificado, la herramienta se detiene y revierte el proceso de instalación, emite una advertencia y sale con un código distinto de cero. + +* `after`: Una lista priorizada de hermanos aceptados después de lo cual al añadir el fragmento de XML. Ãtil para especificar los cambios en los archivos que requieren estricta ordenación de elementos XML como <http://msdn.microsoft.com/en-us/library/windowsphone/develop/ff769509%28v=vs.105%29.aspx#BKMK_EXTENSIONSelement> + +La plataforma de Windows soporta dos atributos adicionales (ambos opcional) cuando afectan la meta-nombre `package.appxmanifest`: + +El atributo de `device-target` indica que el sólo debe incluir al construir para el tipo de dispositivo de destino especificado. Los valores admitidos son `win`, `phone`o `all`. + +El atributo de `versions` indica que sólo se modificara manifiestos de aplicación para las versiones especÃficas de Windows para las versiones que coinciden con la cadena de versión especificada. Valor puede ser cualquier cadena de nodo válida versión semántica gama. + +Ejemplos del uso de estos atributos especÃficos de Windows: + + <config-file target="package.appxmanifest" parent="/Package/Capabilities" versions="<8.1.0"> + <Capability Name="picturesLibrary" /> + <DeviceCapability Name="webcam" /> + </config-file> + <config-file target="package.appxmanifest" parent="/Package/Capabilities" versions=">=8.1.0" device-target="phone"> + <DeviceCapability Name="webcam" /> + </config-file> + + +El ejemplo anterior establecerá pre-8.1 plataformas (Windows 8, especÃficamente) que requieren la capacidad de dispositivo `webcam` y la capacidad general de `picturesLibrary` y la capacidad de dispositivo `webcam` se aplican sólo a Windows 8.1 proyectos que construcción para Windows Phone. Windows desktop 8.1 sistemas son sin modificar. + +## *plugins-plist* Elemento + +Es *anticuado* ya que sólo se aplica a cordova-ios 2.2.0 y por debajo. Utilice la etiqueta `< archivo config - >` para las nuevas versiones de Córdoba. + +Ejemplo: + + <config-file target="config.xml" parent="/widget/plugins"> + <feature name="ChildBrowser"> + <param name="ios-package" value="ChildBrowserCommand"/> + </feature> + </config-file> + + +Especifica una clave y el valor para anexar el archivo correcto `AppInfo.plist` en un proyecto de Cordova iOS. Por ejemplo: + + <plugins-plist key="Foo" string="CDVFoo" /> + + +## Elementos de *archivo de recursos* y *archivo de encabezado* + +Como archivos de código fuente, pero especÃficamente para plataformas como iOS que distinguen entre archivos de código fuente, encabezados y recursos. iOS ejemplos: + + <resource-file src="CDVFoo.bundle" /> + <resource-file src="CDVFooViewController.xib" /> + <header-file src="CDVFoo.h" /> + + +Ejemplo de Android: + + <resource-file src="FooPluginStrings.xml" target="res/values/FooPluginStrings.xml" /> + + +## *lib-archivo* Elemento + +Como fuente de recursos y archivos de encabezado, pero especÃficamente para plataformas como BlackBerry 10 que usan las bibliotecas generado por el usuario. Ejemplos: + + <lib-file src="src/BlackBerry10/native/device/libfoo.so" arch="device" /> + <lib-file src="src/BlackBerry10/native/simulator/libfoo.so" arch="simulator" /> + + +Atributos soportados: + +* `src`(obligatorio): la ubicación del archivo relativa a `plugin.xml` . Si `src` no se encuentra, plugman se detiene y revierte la instalación, problemas de una advertencia sobre el problema y sale con un código distinto de cero. + +* `arch`: La arquitectura para que la `.so` archivo se ha construido, ya sea `device` o`simulator`. + +Para la plataforma Windows, el elemento `< lib-file >` permite la inclusión de un `< SDKReference >` en los archivos de proyecto de Windows generados. + +Atributos soportados: + +* `src`(requerido): el nombre del SDK para incluir (que se utilizará como valor de la `Include` atributo de la generado `<SDKReference>` elemento). + +* `arch`: Indica que el `<SDKReference>` sólo debe incluir al edificio de la arquitectura especificada. Los valores admitidos son `x86` , `x64` o`ARM`. + +* `device-target`: Indica que el `<SDKReference>` sólo debe incluir al edificio para el tipo de dispositivo de destino especificado. Los valores admitidos son `win` (o `windows` ), `phone` o`all`. + +* `versions`: Indica que el `<SDKReference>` sólo debe incluir al construir las versiones que coinciden con la cadena de versión especificado. Valor puede ser cualquier cadena de rango de nodo válido versión semántica. + +Ejemplos: + + <lib-file src="Microsoft.WinJS.2.0, Version=1.0" arch="x86" /> + <lib-file src="Microsoft.WinJS.2.0, Version=1.0" versions=">=8.1" /> + <lib-file src="Microsoft.WinJS.2.0, Version=1.0" target="phone" /> + <lib-file src="Microsoft.WinJS.2.0, Version=1.0" target="win" versions="8.0" arch="x86" /> + + +## *marco* Elemento + +Identifica un marco (generalmente parte de la plataforma/OS) de la cual depende el plugin. + +El atributo opcional `custom` es un valor booleano que indica si el marco es que se incluye como parte de los archivos de plugin (por lo tanto no es un marco de sistema). + +### *marco* para iOS + + <framework src="libsqlite3.dylib" /> + <framework src="social.framework" weak="true" /> + <framework src="relative/path/to/my.framework" custom="true" /> + + +El atributo opcional `weak` es un valor booleano que indica si el marco debe vincularse débil. El valor predeterminado es `false`. + +### *marco* para Android + +En Android (a partir de cordova-android@4.0.0), *marco* etiquetas se utilizan para incluir las dependencias de Maven, o incluir proyectos de biblioteca incorporada. + +Ejemplos: + + <!-- Depend on latest version of GCM from play services --> + <framework src="com.google.android.gms:play-services-gcm:+" /> + <!-- Depend on v21 of appcompat-v7 support library --> + <framework src="com.android.support:appcompat-v7:21+" /> + <!-- Depend on library project included in plugin --> + <framework src="relative/path/FeedbackLib" custom="true" /> + + +*marco* puede utilizarse también para tener archivos personalizados .gradle sub-incluidos en el principal archivo del proyecto .gradle: + + <framework src="relative/path/rules.gradle" custom="true" type="gradleReference" /> + + +Para pre-android@4.0.0 (ANT-proyectos): + +El atributo opcional `type` es una cadena que indica el tipo de marco para agregar. Actualmente, sólo `projectReference` es compatible y sólo para Windows. Usando `custom='true'` y `tipo = 'projectReference'` se agregue una referencia al proyecto que se agregarán a la compilación + enlace pasos del proyecto cordova. Esencialmente es la única forma actualmente que un marco 'custom' puede hacer objetivo a múltiples arquitecturas como se construyen explÃcitamente como una dependencia por la aplicación de Córdoba hace referencia a. + +El opcional `parent` establece la ruta de acceso relativa al directorio que contiene el sub proyecto para agregar la referencia. El valor predeterminado es `.`, es decir, el proyecto de aplicación. Permite añadir referencias entre proyectos de la sub como en este ejemplo: + + <framework src="extras/android/support/v7/appcompat" custom="false" parent="FeedbackLib" /> + + +### *marco* para Windows + +La plataforma de Windows admite tres atributos adicionales (opcionales) para refinar cuando debe incluirse el marco: + + <framework src="path/to/project/LibProj.csproj" custom="true" type="projectReference"/> + + +El `arch` atributo indica que el marco sólo se incluyera al edificio para la arquitectura especificada. Los valores admitidos son `x86` , `x64` o`ARM`. + +El atributo de `device-target` indica que el sólo debe incluir al construir para el tipo de dispositivo de destino especificado. Los valores admitidos son `win` (o `windows` ), `phone` o`all`. + +El atributo de `versions` indica que el marco sólo debe ser incluido al construir versiones que coinciden con la cadena de versión especificada. Valor puede ser cualquier cadena de rango de nodo válido versión semántica. + +Ejemplos de uso de estos atributos especÃficos de Windows: + + <framework src="src/windows/example.dll" arch="x64" /> + <framework src="src/windows/example.dll" versions=">=8.0" /> + <framework src="src/windows/example.vcxproj" type="projectReference" target="win" /> + <framework src="src/windows/example.vcxproj" type="projectReference" target="all" versions="8.1" arch="x86" /> + + +## *info* Elemento + +Información adicional a los usuarios. Esto es útil cuando se requieren pasos adicionales que no se pueden automatizar fácilmente o están más allá del alcance de plugman. Ejemplos: + + <info> + You need to install __Google Play Services__ from the `Android Extras` section using the Android SDK manager (run `android`). + + You need to add the following line to the `local.properties`: + + android.library.reference.1=PATH_TO_ANDROID_SDK/sdk/extras/google/google_play_services/libproject/google-play-services_lib + </info> + + +## El elemento *hook* + +Representa la secuencia de comandos personalizada que será llamado por Córdoba cuando se produce cierta acción (por ejemplo, después se agrega el plugin o plataforma preparar lógica se invoca). Esto es útil cuando se necesita extender la funcionalidad de Cordova por defecto. Para más información vea la guÃa de los ganchos. + + <hook type="after_plugin_install" src="scripts/afterPluginInstall.js" /> + + +## Variables + +En ciertos casos, puede necesitar un plugin hacer cambios de configuración depende de la aplicación de destino. Por ejemplo, para registrarse en C2DM en Android, una aplicación cuya id de paquete es `com.alunny.message` requerirÃa un permiso como: + + <uses-permission android:name="com.alunny.message.permission.C2D_MESSAGE"/> + + +En estos casos donde no se conoce el contenido insertado en el archivo `plugin.xml` antes de tiempo, variables pueden indicarse por un signo de dólar seguido por una serie de letras, dÃgitos o subrayados. Para el ejemplo anterior, el archivo `plugin.xml` incluir esta etiqueta: + + <uses-permission android:name="$PACKAGE_NAME.permission.C2D_MESSAGE"/> + + +plugman substituye referencias a variables con el valor especificado o la cadena vacÃa si no se encuentra. El valor de la referencia de variable puede ser detectado (en este caso, desde el archivo `AndroidManifest.xml` ) o especificado por el usuario de la herramienta; el proceso exacto depende de la herramienta especial. + +plugman puede solicitar a los usuarios especificar variables requiere de un plugin. Por ejemplo, las llaves de la API para C2M y Google Maps pueden especificarse como un argumento de lÃnea de comandos: + + plugman --platform android --project /path/to/project --plugin name|git-url|path --variable API_KEY=!@CFATGWE%^WGSFDGSDFW$%^#$%YTHGsdfhsfhyer56734 + + +Para realizar la variable obligatoria, la etiqueta `< platform >` debe contener una etiqueta `< preference >` . Por ejemplo: + + <preference name="API_KEY" /> + + +plugman comprueba que estas preferencias requiere pasan en. Si no, debe advertir al usuario de cómo pasar la variable y la salida con un código distinto de cero. + +Ciertos nombres de variable deben ser reservados, que se enumeran a continuación. + +## $PACKAGE_NAME + +El identificador único de estilo de dominio reverso para el paquete, correspondiente a la `CFBundleIdentifier` de iOS o el atributo de `paquete` del elemento de nivel superior `se manifiestan` en el archivo `AndroidManifest.xml` . \ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/5ad93d20/www/docs/fr/7.x/config_ref/images.md ---------------------------------------------------------------------- diff --git a/www/docs/fr/7.x/config_ref/images.md b/www/docs/fr/7.x/config_ref/images.md new file mode 100644 index 0000000..18d7aee --- /dev/null +++ b/www/docs/fr/7.x/config_ref/images.md @@ -0,0 +1,173 @@ +--- +license: > + Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +title: Icones et Splash Screen +toc_title: Customize icons +--- + +# Icones et Splash Screen + +Cette section indique comment configurer une icône et un écran de démarrage facultatif pour une application sur diverses plates-formes, les deux lorsque vous travaillez dans la CLI de Cordova (décrites dans l'Interface de ligne de commande) ou en utilisant les outils du SDK spécifique à la plateforme (détaillées dans les Guides de la plate-forme). + +## Configuration des icônes dans le CLI + +Quand travaillant dans la CLI, vous pouvez définir des app icônes via `<icon>` élément ( `config.xml` ). Si vous ne spécifiez pas une icône, puis le logo Apache Cordova est utilisé. + + <icon src="res/ios/icon.png" platform="ios" width="57" height="57" density="mdpi" /> + + +SRC: (obligatoire) spécifie l'emplacement du fichier image, par rapport à votre répertoire de projet + +plateforme : plateforme cible (facultatif) + +Largeur : largeur d'icône (facultatif) en pixels + +hauteur : hauteur d'icône (facultatif) en pixels + +densité : android (facultatif) spécifique, spécifie la densité de l'icône + +La configuration suivante peut être utilisée pour définir l'icône par défaut unique qui sera utilisé pour toutes les plates-formes. + + <icon src="res/icon.png" /> + + +Pour chaque plate-forme, vous pouvez également définir un set pour s'adapter à des résolutions d'écran différentes d'icônes de pixellisés. + +Amazon Fire OS + + <platform name="amazon-fireos"> + <icon src="res/android/ldpi.png" density="ldpi" /> + <icon src="res/android/mdpi.png" density="mdpi" /> + <icon src="res/android/hdpi.png" density="hdpi" /> + <icon src="res/android/xhdpi.png" density="xhdpi" /> + </platform> + + +Android + + <platform name="android"> + <icon src="res/android/ldpi.png" density="ldpi" /> + <icon src="res/android/mdpi.png" density="mdpi" /> + <icon src="res/android/hdpi.png" density="hdpi" /> + <icon src="res/android/xhdpi.png" density="xhdpi" /> + </platform> + + +BlackBerry10 + + <platform name="blackberry10"> + <icon src="res/bb10/icon-86.png" /> + <icon src="res/bb10/icon-150.png" /> + </platform> + + +Voir la documentation de BlackBerry pour le ciblage de plusieurs tailles et paramètres régionaux. [http://developer.blackberry.com/html5/documentation/icon_element.html] + +Firefox OS + + <platform name="firefoxos"> + <icon src="res/ff/logo.png" width="60" height="60" /> + </platform> + + +iOS + + < nom de plate-forme = "ios" ><!--iOS 8.0 +--> <!--iPhone Plus 6--> < icône src = "res/ios/icon...@3x.png" width = "180" height = "180" / ><!--iOS 7.0 +--> <!--iPhone / iPod Touch--> < icône src="res/ios/icon-60.png" largeur = "60" height = "60" / >< icône src = "res/ios/icon...@2x.png" width = "120" height = "120" / ><!--iPad--> < icône src="res/ios/icon-76.png" largeur = hauteur "76" = "76" / >< icône src = "res/ios/icon...@2x.png" width = "152" height = "152" /><!--iOS 6.1--> <!--icône Spotlight--> < icône src="res/ios/icon-40.png" largeur = "40" height = "40" / >< icône src = "res/ios/icon...@2x.png" width = "80" height = "80" / ><!--iPhone / iPod Touch--> < icône src="res/ios/icon.png" largeur = "57" height = "57" / >< icône src = "res/ios/i...@2x.png" width = "114" height = "114" / ><!--iPad--> < icône src="res/ios/icon-72.png" largeur = hauteur "72" = "72" / >< icône src = "res/ios/icon...@2x.png" width = "144" hauteur = "144" / ><!--iPhone Spotlight et i cône Paramètres--> < icône src="res/ios/icon-small.png" largeur = "29" height = "29" / >< icône src = "res/ios/icon-sm...@2x.png" width = height "58" = "58" / ><!--iPad Spotlight et icône Paramètres--> < icône src="res/ios/icon-50.png" largeur = "50" height = "50" / >< icône src = "res/ios/icon...@2x.png" width = "100" height = "100" / >< / plate-forme > + + +Paciarelli + + <platform name="tizen"> + <icon src="res/tizen/icon-128.png" width="128" height="128" /> + </platform> + + +Windows Phone8 + + <platform name="wp8"> + <icon src="res/wp/ApplicationIcon.png" width="99" height="99" /> + <!-- tile image --> + <icon src="res/wp/Background.png" width="159" height="159" /> + </platform> + + +Windows8 + + <platform name="windows8"> + <icon src="res/windows8/logo.png" width="150" height="150" /> + <icon src="res/windows8/smalllogo.png" width="30" height="30" /> + <icon src="res/windows8/storelogo.png" width="50" height="50" /> + </platform> + + +## Configuration du Splashscreen dans la CLI + +Dans le premier niveau `config.xml` fichier (pas celui de `platforms` ), ajouter des éléments de configuration tels que celles spécifiées ici. + +# Exemple de configuration + +Veuillez noter que la valeur de l'attribut « src » est relatif au répertoire de projet et de ne pas le répertoire www. Vous pouvez nommer l'image source, ce qui vous plait. Le nom interne de l'application sont déterminées par Cordova. + + <platform name="android"> + <!-- you can use any density that exists in the Android project --> + <splash src="res/screen/android/splash-land-hdpi.png" density="land-hdpi"/> + <splash src="res/screen/android/splash-land-ldpi.png" density="land-ldpi"/> + <splash src="res/screen/android/splash-land-mdpi.png" density="land-mdpi"/> + <splash src="res/screen/android/splash-land-xhdpi.png" density="land-xhdpi"/> + + <splash src="res/screen/android/splash-port-hdpi.png" density="port-hdpi"/> + <splash src="res/screen/android/splash-port-ldpi.png" density="port-ldpi"/> + <splash src="res/screen/android/splash-port-mdpi.png" density="port-mdpi"/> + <splash src="res/screen/android/splash-port-xhdpi.png" density="port-xhdpi"/> + </platform> + + <platform name="ios"> + <!-- images are determined by width and height. Suivants sont pris en charge--> < éclabousser src="res/screen/ios/Default~iphone.png" largeur = "320" height = "480" / >< éclabousser src="res/screen/ios/Default@2x~iphone.png" largeur = "640" height = "960" / >< éclabousser src="res/screen/ios/Default-Portrait~ipad.png" largeur = "768" hauteur = "1024" / >< éclabousser src="res/screen/ios/Default-Portrait@2x~ipad.png" largeur = "1536" height = "2048" / >< éclabousser src="res/screen/ios/Default-Landscape~ipad.png" largeur = "1024" height = "768" / >< éclabousser src="res/screen/ios/Default-Landscape@2x~ipad.png" largeur = "2048" hauteur = "1536" / >< éclabousser src="res/screen/ios/Default-568h@2x~iphone.png" largeur = "640" height = "1136" / >< éclabousser src="res/screen/ios/Default-667h.png" largeur = "750" height = "1334" / >< éclabousser src="res/screen/ios/Default-736h.png" largeur = "1242" height = "2208" / >< éclabousser src="res/screen/ios/Default-Landscape- 736h.png" largeur = "2208" height = "1242" / >< / plateforme >< nom de plate-forme = "at 8" ><!--images sont déterminées par la largeur et la hauteur. The following are supported --> + <splash src="res/screen/wp8/SplashScreenImage.jpg" width="768" height="1280"/> + </platform> + + <platform name="windows8"> + <!-- images are determined by width and height. The following are supported --> + <splash src="res/screen/windows8/splashscreen.png" width="620" height="300"/> + </platform> + + <platform name="blackberry10"> + <!-- Add a rim:splash element for each resolution and locale you wish --> + <!-- http://developer.blackberry.com/html5/documentation/rim_splash_element.html --> + <rim:splash src="res/screen/windows8/splashscreen.png"/> + </platform> + + + <preference name="SplashScreenDelay" value="10000" /> + + +# Plates-formes prises en charge + +A partir de maintenant (Cordova 3.5.0 juillet 2014) les plates-formes suivants prennent en charge les écrans de démarrage. + + android + ios + wp8 + windows8 + blackberry10 + + +# SplashScreen Plugin + +Apache Cordova offre également des projections spéciales écran plugin qui pourrait servir à afficher et masquer un écran de démarrage pendant https://github.com/apache/cordova-plugin-splashscreen lancement application par programme \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/5ad93d20/www/docs/fr/7.x/config_ref/index.md ---------------------------------------------------------------------- diff --git a/www/docs/fr/7.x/config_ref/index.md b/www/docs/fr/7.x/config_ref/index.md new file mode 100644 index 0000000..56999ba --- /dev/null +++ b/www/docs/fr/7.x/config_ref/index.md @@ -0,0 +1,192 @@ +--- +license: > + Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +title: Le fichier config.xml +toc_title: Config.xml +--- + +# Le fichier config.xml + +Plusieurs aspects du comportement de l'application peuvent être contrôlés avec un fichier de configuration global, `config.xml` . Ce fichier XML de plate-forme agnostique est organisé selon spécification [Emballés Web Applications (Widgets)][1] de la W3C et s'étend pour spécifier des caractéristiques de Cordova API de base, des plugins et des paramètres spécifiques à la plateforme. + + [1]: http://www.w3.org/TR/widgets/ + +Pour les projets créés avec la CLI Cordova (décrites dans l'Interface de ligne de commande), ce fichier se trouve dans le répertoire de niveau supérieur : + + app/config.xml + + +Notez qu'avant la version 3.3.1-0.2.0, le fichier existait au `app/www/config.xml` , et qu'il avoir ici est toujours supporté. + +Lorsque vous utilisez l'interface CLI pour générer un projet, les versions de ce fichier sont copiées passivement dans divers `platforms/` sous-répertoires, par exemple : + + app/platforms/ios/AppName/config.xml + app/platforms/blackberry10/www/config.xml + app/platforms/android/res/xml/config.xml + + +Cette section décrit en détail les options de configuration globale et multi-plateforme. Consultez les sections suivantes pour les options spécifiques à la plateforme : + +* Configuration iOS +* Configuration Android +* [Configuration de blackBerry](../guide/platforms/blackberry/config.html) 10 + +Outre les diverses options de configuration détaillées ci-dessous, vous pouvez également configurer ensemble de base d'une application d'images pour chaque plate-forme cible. Pour plus d'informations, consultez icônes et écrans de démarrage. + +## Ãléments de configuration de base + +Cet exemple affiche la valeur par défaut `config.xml` généré par le CLI `create` commande, décrite dans l'Interface de ligne de commande : + + <widget id="com.example.hello" version="0.0.1"> + <name>HelloWorld</name> + <description> + A sample Apache Cordova application that responds to the deviceready event. + </description> + <author email="d...@callback.apache.org" href="http://cordova.io";> + Apache Cordova Team + </author> + <content src="index.html" /> + <access origin="*" /> + </widget> + + +Les éléments de configuration suivants apparaissent dans le premier niveau `config.xml` du fichier et sont pris en charge sur toutes les plateformes prises en charge de Cordoue : + +* La `<widget>` de l'élément `id` attribut fournit l'identificateur de domaine inverse du PPA et les `version` son numéro de version complet exprimé en notation majeur/mineur/patch. + + La balise widget peut également avoir des attributs qui spécifient les versions alternatives, à savoir versionCode pour Android et CFBundleVersion pour iOS. Consultez la section gestion des versions supplémentaires ci-dessous pour plus de détails. + +* L'élément `<name>` spécifie le nom formel de l'application, tel qu'il apparaît sur l'écran d'accueil de l'appareil et dans le app-store. + +* Le `<description>` et `<author>` éléments spécifient les métadonnées et les informations de contact qui peuvent apparaître au sein de l'app-store listings. + +* Le paramètre optionnel `<content>` élément définit la page de démarrage de l'application dans le répertoire actif de web de niveau supérieur. La valeur par défaut est `index.html` , qui apparaît habituellement dans le dossier de niveau supérieur du projet, `www`. + +* Les éléments `<access>` définissent l'ensemble des domaines externes avec lesquels l'application est autorisée à communiquer. La valeur par défaut ci-dessus permet d'accéder à n'importe quel serveur. Consultez le Guide de liste blanche de domaine pour plus de détails. + +* La balise `<preference>` définit différentes options sous forme de paires d'attributs `name` / `value`. Le `name` de chaque préférence est insensible à la casse. Plusieurs préférences sont spécifiques à certaines plateformes, comme indiqué en haut de cette page. Les sections suivantes détaillent les préférences qui s'appliquent à plus d'une plateforme. + +### Gestion des versions supplémentaires + +Fois, Android et iOS prend en charge une deuxième chaîne de la version (ou nombre) en plus de celui visible dans l'app store, [versionCode][2] pour Android et [CFBundleVersion][3] pour iOS. Voici un exemple qui définit explicitement versionCode et CFBundleVersion + + [2]: http://developer.android.com/tools/publishing/versioning.html + [3]: http://stackoverflow.com/questions/4933093/cfbundleversion-in-the-info-plist-upload-error + + <widget id="io.cordova.hellocordova" + version="0.0.1" + android-versionCode="7" + ios-CFBundleVersion="3.3.3"> + + +Si la version alternative n'est pas spécifiée, les paramètres par défaut suivants seront utilisés : + + // assuming version = MAJOR.MINOR.PATCH-whatever + versionCode = PATCH + MINOR * 100 + MAJOR * 10000 + CFBundleVersion = "MAJOR.MINOR.PATCH" + + +## Préférences globales + +Les préférences globales suivantes s'appliquent à toutes les plateformes : + +* `Fullscreen`permet de masquer la barre d'état en haut de l'écran. La valeur par défaut est `false` . Exemple : + + <preference name="Fullscreen" value="true" /> + + +## Préférences de multi-plateformes + +Les préférences suivantes s'appliquent à plus d'une plate-forme, mais pas tous d'entre eux : + +* `DisallowOverscroll`(boolean, la valeur par défaut `false` ): la valeur `true` si vous ne voulez pas l'interface pour afficher n'importe quelle rétroaction lorsque les utilisateurs faire défiler devant le début ou la fin du contenu. + + <preference name="DisallowOverscroll" value="true"/> + + + S'applique à Android et iOS. Sur iOS, un mouvement de défilement exagéré fera rebondir le contenu à sa position initiale. Sur Android, ils produisent un effet brillant plus subtil le long du rebord en haut ou en bas du contenu. + +* `BackgroundColor`: Définir la couleur d'arrière-plan de l'application. Prend en charge une valeur hexadécimale de quatre octets, avec le premier octet qui représente le canal alpha et les valeurs RGB standards pour les trois octets suivants. Cet exemple spécifie bleu : + + <preference name="BackgroundColor" value="0xff0000ff"/> + + + S'applique à Android et BlackBerry. Substitue des CSS autrement disponibles sur *toutes* les plateformes, par exemple :`body{background-color:blue}`. + +* `HideKeyboardFormAccessoryBar`(boolean, la valeur par défaut `false` ): la valeur `true` pour masquer la barre d'outils supplémentaire qui apparaît au-dessus du clavier, aidant les utilisateurs navigueront d'un formulaire de saisie à l'autre. + + <preference name="HideKeyboardFormAccessoryBar" value="true"/> + + + S'applique aux BlackBerry. + +* `Orientation`(string, la valeur par défaut `default` ): permet de verrouiller l'orientation et d'empêcher toute rotation en réponse aux changements dans l'orientation de l'interface. Les valeurs possibles sont `default` , `landscape` ou `portrait` . Exemple : + + < nom de l'option = « Orientation » value = « paysage » / > + + + En outre, vous pouvez spécifier n'importe quelle valeur d'orientation spécifique à la plateforme si vous placez le `<preference>` élément dans une `<platform>` élément : + + <platform name="android"> + <preference name="Orientation" value="sensorLandscape" /> + </platform> + + + S'applique à Android, iOS, WP8, Amazon Fire OS et OS de Firefox. + + **NOTE**: le `default` valeur signifie Cordova supprimera l'entrée de préférence d'orientation du fichier de manifeste/configuration de la plate-forme, permettant à la plate-forme de secours pour son comportement par défaut. + + Pour iOS, afin de spécifier les deux portrait & mode paysage, vous utiliseriez la `all`plate-forme valeur spécifique : + + <platform name="ios"> + <preference name="Orientation" value="all" /> + </platform> + +## La *fonctionnalité* élément + +Si vous utilisez la CLI pour créer des applications, vous utilisez la commande `plugin` pour activer le dispositif API. Cela ne modifie pas le fichier de niveau supérieur `config.xml` , aussi l'élément `< feature >` ne s'applique pas à votre flux de travail. Si vous êtes travaillant directement dans un kit de développement logiciel et à l'aide de la plate-forme spécifique `config.xml` fichier source, vous utilisez le `<feature>` tag pour permettre aux API de niveau périphérique et des plugins externes. Elles apparaissent souvent avec des valeurs personnalisées dans les fichiers spécifiques à une plateforme `config.xml` . Par exemple, voici comment spécifier l'API Device pour les projets Android : + + <feature name="Device"> + <param name="android-package" value="org.apache.cordova.device.Device" /> + </feature> + + +Voici l'apparence de l'élément pour les projets d'iOS : + + <feature name="Device"> + <param name="ios-package" value="CDVDevice" /> + </feature> + + +Voir la référence de l'API pour plus d'informations sur la façon de spécifier chaque fonctionnalité. Consultez le Guide de développement de Plugin pour plus d'informations sur les plugins. + +## La *plate-forme* élément + +Lorsque vous utilisez l'interface CLI pour créer des applications, il est parfois nécessaire de spécifier les préférences ou autres éléments spécifiques à une plate-forme particulière. Utilisez l'élément `< platform >` pour spécifier la configuration qui doit uniquement apparaître dans un fichier unique spécifique à la plateforme `config.xml` . Par exemple, voici comment spécifier que seul android devrait utiliser les préférences de plein écran : + + <platform name="android"> + <preference name="Fullscreen" value="true" /> + </platform> + + +## Le *hook* élément + +Représente votre script personnalisé qui sera appelé par Cordova en cas de certaines actions (par exemple, est appelé après plugin est ajouté ou plate-forme préparer logique). Ceci est utile lorsque vous avez besoin d'étendre les fonctionnalités de Cordoue par défaut. Voir [Guide de crochets](../guide/appdev/hooks/index.html) pour plus d'informations. + + <hook type="after_plugin_install" src="scripts/afterPluginInstall.js" /> \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/5ad93d20/www/docs/fr/7.x/cordova/events/events.backbutton.md ---------------------------------------------------------------------- diff --git a/www/docs/fr/7.x/cordova/events/events.backbutton.md b/www/docs/fr/7.x/cordova/events/events.backbutton.md new file mode 100644 index 0000000..36015b7 --- /dev/null +++ b/www/docs/fr/7.x/cordova/events/events.backbutton.md @@ -0,0 +1,82 @@ +--- +license: > + Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +title: backbutton +--- + +# backbutton + +L'évènement se déclenche lorsque l'utilisateur appuie sur le bouton retour. + + document.addEventListener("backbutton", yourCallbackFunction, false); + + +## Détails + +Afin de modifier le comportement par défaut du bouton retour, attachez un écouteur pour l'évènement `backbutton` généralement en appelant `document.addEventListener` une fois l'évènement `[deviceready](events.deviceready.html)` reçu. Il n'est désormais plus nécessaire d'appeler d'autres méthodes pour altérer le comportement du bouton retour. + +## Plates-formes supportées + +* Amazon Fire OS +* Android +* BlackBerry 10 +* Windows Phone 8 + +## Exemple court + + document.addEventListener("backbutton", onBackKeyDown, false); + + function onBackKeyDown() { + // Handle the back button + } + + +## Exemple complet + + <!DOCTYPE html> + <html> + <head> + <title>Back Button Example</title> + + <script type="text/javascript" charset="utf-8" src="cordova.js"></script> + <script type="text/javascript" charset="utf-8"> + + // Wait for device API libraries to load + // + function onLoad() { + document.addEventListener("deviceready", onDeviceReady, false); + } + + // device APIs are available + // + function onDeviceReady() { + // Register the event listener + document.addEventListener("backbutton", onBackKeyDown, false); + } + + // Handle the back button + // + function onBackKeyDown() { + } + + </script> + </head> + <body onload="onLoad()"> + </body> + </html> \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/5ad93d20/www/docs/fr/7.x/cordova/events/events.deviceready.md ---------------------------------------------------------------------- diff --git a/www/docs/fr/7.x/cordova/events/events.deviceready.md b/www/docs/fr/7.x/cordova/events/events.deviceready.md new file mode 100644 index 0000000..4ed495b --- /dev/null +++ b/www/docs/fr/7.x/cordova/events/events.deviceready.md @@ -0,0 +1,85 @@ +--- +license: > + Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +title: deviceready +--- + +# deviceready + +L'évènement se déclenche lorsque Cordova est entièrement chargé. + + document.addEventListener("deviceready", yourCallbackFunction, false); + + +## Détails + +Cet évènement est essentiel à n'importe quelle application. Il signale que les API matérielles Cordova ont été chargées et sont prêtes à être utilisées. + +Cordova est constitué de deux bases de code : native et JavaScript. Tant que le code natif est en cours de chargement, une image personnalisée est affichée. Cependant, le code JavaScript est chargé seulement lorsque le DOM charge. Cela signifie que l'application web peut potentiellement appeler une fonction Cordova JavaScript avant le code natif correspondant soit disponible. + +L'évènement `deviceready` se déclenche quand Cordova est totalement chargé. Une fois cet évènement déclenché, vous pouvez en toute sécurité faire appels aux API Cordova. Les applications devraient en général utiliser `document.addEventListener` pour attacher un écouteur d'évènements, une fois le DOM du document HTML chargé. + +L'évènement `deviceready` se comporte différemment des autres évènements. Tout gestionnaire additionnel enregistré après le déclenchement de `deviceready` est appelé immédiatement. + +## Plates-formes supportées + +* Amazon Fire OS +* Android +* BlackBerry 10 +* iOS +* Paciarelli +* Windows Phone 8 +* Windows 8 + +## Exemple court + + document.addEventListener("deviceready", onDeviceReady, false); + + function onDeviceReady() { + // Now safe to use device APIs + } + + +## Exemple complet + + <!DOCTYPE html> + <html> + <head> + <title>Device Ready Example</title> + + <script type="text/javascript" charset="utf-8" src="cordova.js"></script> + <script type="text/javascript" charset="utf-8"> + + // Wait for device API libraries to load + // + function onLoad() { + document.addEventListener("deviceready", onDeviceReady, false); + } + + // device APIs are available + // + function onDeviceReady() { + // Now safe to use device APIs + } + + </script> + </head> + <body onload="onLoad()"> + </body> + </html> \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/5ad93d20/www/docs/fr/7.x/cordova/events/events.endcallbutton.md ---------------------------------------------------------------------- diff --git a/www/docs/fr/7.x/cordova/events/events.endcallbutton.md b/www/docs/fr/7.x/cordova/events/events.endcallbutton.md new file mode 100644 index 0000000..54c226a --- /dev/null +++ b/www/docs/fr/7.x/cordova/events/events.endcallbutton.md @@ -0,0 +1,82 @@ +--- +license: > + Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +title: endcallbutton +--- + +# endcallbutton + +Cet évènement se déclenche lorsque l'utilisateur appuie sur la touche fin d'appel. + + document.addEventListener("endcallbutton", yourCallbackFunction, false); + + +## Détails + +L'évènement modifie le comportement par défaut de la touche fin d'appel. + +Les applications devraient en général utiliser `document.addEventListener` pour attacher un écouteur d'évènements, une fois l'évènement `[deviceready](events.deviceready.html)` déclenché. + +## Plates-formes supportées + +* BlackBerry 10 + +## Exemple court + + document.addEventListener("endcallbutton", onEndCallKeyDown, false); + + function onEndCallKeyDown() { + // Handle the end call button + } + + +## Exemple complet + + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" + "http://www.w3.org/TR/html4/strict.dtd";> + <html> + <head> + <title>End Call Button Example</title> + + <script type="text/javascript" charset="utf-8" src="cordova.js"></script> + <script type="text/javascript" charset="utf-8"> + + // Wait for device API libraries to load + // + function onLoad() { + document.addEventListener("deviceready", onDeviceReady, false); + } + + // device APIs are available + // + function onDeviceReady() { + // Register the event listener + document.addEventListener("endcallbutton", onEndCallKeyDown, false); + } + + // Handle the end call button + // + function onEndCallKeyDown() { + } + + </script> + </head> + <body onload="onLoad()"> + </body> + </html> \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/5ad93d20/www/docs/fr/7.x/cordova/events/events.md ---------------------------------------------------------------------- diff --git a/www/docs/fr/7.x/cordova/events/events.md b/www/docs/fr/7.x/cordova/events/events.md new file mode 100644 index 0000000..8f7d406 --- /dev/null +++ b/www/docs/fr/7.x/cordova/events/events.md @@ -0,0 +1,54 @@ +--- +license: > + Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +title: Ãvènements +toc_title: Events +--- + +# Ãvènements + +> Ãvènements du cycle de vie de Cordova. + +## Types d'évènements + +* [deviceready](events.deviceready.html) +* [pause](events.pause.html) +* [resume](events.resume.html) +* [backbutton](events.backbutton.html) +* [menubutton](events.menubutton.html) +* [searchbutton](events.searchbutton.html) +* [startcallbutton](events.startcallbutton.html) +* [endcallbutton](events.endcallbutton.html) +* [volumedownbutton](events.volumedownbutton.html) +* [volumeupbutton](events.volumeupbutton.html) + +## Ãvénements ajoutés par [cordova-plugin-batterie-statut][1] + + [1]: https://github.com/apache/cordova-plugin-battery-status/blob/master/README.md + +* batterycritical +* batterylow +* batterystatus + +## Ãvénements ajoutés par [cordova-plugin-réseau-informations][2] + + [2]: https://github.com/apache/cordova-plugin-network-information/blob/master/README.md + +* online +* offline \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/5ad93d20/www/docs/fr/7.x/cordova/events/events.menubutton.md ---------------------------------------------------------------------- diff --git a/www/docs/fr/7.x/cordova/events/events.menubutton.md b/www/docs/fr/7.x/cordova/events/events.menubutton.md new file mode 100644 index 0000000..c242697 --- /dev/null +++ b/www/docs/fr/7.x/cordova/events/events.menubutton.md @@ -0,0 +1,84 @@ +--- +license: > + Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +title: menubutton +--- + +# menubutton + +L'évènement se déclenche lorsque l'utilisateur appuie sur la touche menu. + + document.addEventListener("menubutton", yourCallbackFunction, false); + + +## Détails + +Appliquer un gestionnaire d'évènements remplace le comportement par défaut du bouton menu. + +Les applications devraient en général utiliser `document.addEventListener` pour attacher un écouteur d'évènements, une fois l'évènement `[deviceready](events.deviceready.html)` déclenché. + +## Plates-formes supportées + +* Amazon Fire OS +* Android +* BlackBerry 10 + +## Exemple court + + document.addEventListener("menubutton", onMenuKeyDown, false); + + function onMenuKeyDown() { + // Handle the back button + } + + +## Exemple complet + + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" + "http://www.w3.org/TR/html4/strict.dtd";> + <html> + <head> + <title>Menu Button Example</title> + + <script type="text/javascript" charset="utf-8" src="cordova.js"></script> + <script type="text/javascript" charset="utf-8"> + + // Wait for device API libraries to load + // + function onLoad() { + document.addEventListener("deviceready", onDeviceReady, false); + } + + // device APIs are available + // + function onDeviceReady() { + // Register the event listener + document.addEventListener("menubutton", onMenuKeyDown, false); + } + + // Handle the menu button + // + function onMenuKeyDown() { + } + + </script> + </head> + <body onload="onLoad()"> + </body> + </html> \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/5ad93d20/www/docs/fr/7.x/cordova/events/events.pause.md ---------------------------------------------------------------------- diff --git a/www/docs/fr/7.x/cordova/events/events.pause.md b/www/docs/fr/7.x/cordova/events/events.pause.md new file mode 100644 index 0000000..79bbe9f --- /dev/null +++ b/www/docs/fr/7.x/cordova/events/events.pause.md @@ -0,0 +1,94 @@ +--- +license: > + Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +title: pause +--- + +# pause + +L'évènement se déclenche quand une application est mise en arrière-plan. + + document.addEventListener("pause", yourCallbackFunction, false); + + +## Détails + +L'évènement `pause` se déclenche lorsque la plate-forme native met l'application en arrière-plan, généralement lorsque l'utilisateur bascule vers une autre application. + +Les applications devraient en général utiliser `document.addEventListener` pour attacher un écouteur d'évènements, une fois l'évènement `[deviceready](events.deviceready.html)` déclenché. + +## Plates-formes supportées + +* Amazon Fire OS +* Android +* BlackBerry 10 +* iOS +* Windows Phone 8 +* Windows 8 + +## Exemple court + + document.addEventListener("pause", onPause, false); + + function onPause() { + // Handle the pause event + } + + +## Exemple complet + + <!DOCTYPE html> + <html> + <head> + <title>Pause Example</title> + + <script type="text/javascript" charset="utf-8" src="cordova.js"></script> + <script type="text/javascript" charset="utf-8"> + + // Wait for device API libraries to load + // + function onLoad() { + document.addEventListener("deviceready", onDeviceReady, false); + } + + // device APIs are available + // + function onDeviceReady() { + document.addEventListener("pause", onPause, false); + } + + // Handle the pause event + // + function onPause() { + } + + </script> + </head> + <body onload="onLoad()"> + </body> + </html> + + +## Notes au sujet d'iOS + +Dans un gestionnaire de l'évènement `pause`, tous les appels à l'API Cordova ou vers des plugins natifs passant par l'Objective-C ne fonctionnent pas, de même pour tous les appels interactifs tels que des alertes ou `console.log()`. Ceux-ci sont traités uniquement lorsque l'application revient au premier plan, lors du prochain passage de la boucle d'exécution. + +Sous iOS, l'évènement spécifique `resign` est disponible comme alternative à `pause` et détecte quand les utilisateurs pressent le bouton de **verrouillage** pour verrouiller l'appareil avec l'application en cours d'exécution au premier plan. Si l'application (et l'appareil) est prévue pour le multitâche, un évènement `pause` lui est ultérieurement associé, mais seulement sous iOS 5. En réalité, sous iOS 5, toutes les applications verrouillées prévues pour le multitâche sont envoyées à l'arrière-plan. Afin qu'une application puisse continuer à s'exécuter lorsque l'appareil est verrouillé sous iOS 5, il faudra désactiver le multitâche pour celle-ci en réglant [UIApplicationExitsOnSuspend][1] sur `YES`. Sous iOS 4, l'application continuera de s'exécuter même si l'appareil est verrouillé, modifier la valeur de ce paramètre n'a aucun effet. + + [1]: http://developer.apple.com/library/ios/#documentation/general/Reference/InfoPlistKeyReference/Articles/iPhoneOSKeys.html \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/5ad93d20/www/docs/fr/7.x/cordova/events/events.resume.md ---------------------------------------------------------------------- diff --git a/www/docs/fr/7.x/cordova/events/events.resume.md b/www/docs/fr/7.x/cordova/events/events.resume.md new file mode 100644 index 0000000..1803c6c --- /dev/null +++ b/www/docs/fr/7.x/cordova/events/events.resume.md @@ -0,0 +1,108 @@ +--- +license: > + Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +title: resume +--- + +# resume + +L'évènement se déclenche lorsqu'une application est renvoyée au premier plan. + + document.addEventListener("resume", yourCallbackFunction, false); + + +## Détails + +L'évènement `resume` se déclenche lorsque la plate-forme native sort l'application de l'arrière-plan. + +Les applications devraient en général utiliser `document.addEventListener` pour attacher un écouteur d'évènements, une fois l'évènement `[deviceready](events.deviceready.html)` déclenché. + +## Plates-formes supportées + +* Amazon Fire OS +* Android +* BlackBerry 10 +* iOS +* Windows Phone 8 +* Windows 8 + +## Exemple court + + document.addEventListener("resume", onResume, false); + + function onResume() { + // Handle the resume event + } + + +## Exemple complet + + <!DOCTYPE html> + <html> + <head> + <title>Resume Example</title> + + <script type="text/javascript" charset="utf-8" src="cordova.js"></script> + <script type="text/javascript" charset="utf-8"> + + // Wait for device API libraries to load + // + function onLoad() { + document.addEventListener("deviceready", onDeviceReady, false); + } + + // device APIs are available + // + function onDeviceReady() { + document.addEventListener("resume", onResume, false); + } + + // Handle the resume event + // + function onResume() { + } + + </script> + </head> + <body onload="onLoad()"> + </body> + </html> + + +## Notes au sujet d'iOS + +Toutes les fonctions interactives appelées à partir d'un gestionnaire de l'évènement `[pause](events.pause.html)` s'exécutent plus tard, lorsque l'application est reprise, comme l'évènement `resume` l'indique. Il s'agit notamment d'alertes, `console.log()` et tous les appels vers des plugins ou l'API Cordova passant par l'Objective-C. + +* évènement **active** + + Sous iOS, l'évènement spécifique `active` est disponible comme alternative à `resume` et détecte quand les utilisateurs pressent le bouton de **verrouillage** pour déverrouiller l'appareil avec l'application en cours d'exécution au premier plan. Si l'application (et l'appareil) est prévue pour le multitâche, un évènement `resume` lui est ultérieurement associé, mais seulement sous iOS 5. En réalité, sous iOS 5, toutes les applications verrouillées prévues pour le multitâche sont envoyées à l'arrière-plan. Afin qu'une application puisse continuer à s'exécuter lorsque l'appareil est verrouillé sous iOS 5, il faudra désactiver le multitâche pour celle-ci en réglant [UIApplicationExitsOnSuspend][1] sur `YES`. Sous iOS 4, l'application continuera de s'exécuter même si l'appareil est verrouillé, modifier la valeur de ce paramètre n'a aucun effet. + +* évènement **resume** + + Si appelées depuis un gestionnaire de l'évènement `resume`, les fonctions interactives telles que `alert()` doivent être enveloppées d'un appel à `setTimeout()` avec un délai de zéro millisecondes, sinon l'application sera bloquée. Par exemple : + + document.addEventListener("resume", onResume, false); + function onResume() { + setTimeout(function() { + // TODO: do your thing! + }, 0); + } + + + [1]: http://developer.apple.com/library/ios/#documentation/general/Reference/InfoPlistKeyReference/Articles/iPhoneOSKeys.html \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/5ad93d20/www/docs/fr/7.x/cordova/events/events.searchbutton.md ---------------------------------------------------------------------- diff --git a/www/docs/fr/7.x/cordova/events/events.searchbutton.md b/www/docs/fr/7.x/cordova/events/events.searchbutton.md new file mode 100644 index 0000000..ef212fc --- /dev/null +++ b/www/docs/fr/7.x/cordova/events/events.searchbutton.md @@ -0,0 +1,82 @@ +--- +license: > + Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +title: searchbutton +--- + +# searchbutton + +L'évènement se déclenche lorsque l'utilisateur appuie sur le bouton rechercher sous Android. + + document.addEventListener("searchbutton", yourCallbackFunction, false); + + +## Détails + +Si vous souhaitez modifier le comportement par défaut de bouton rechercher sous Android, vous pouvez enregistrer un écouteur pour l'événement 'searchbutton'. + +Les applications devraient en général utiliser `document.addEventListener` pour attacher un écouteur d'évènements, une fois l'évènement `[deviceready](events.deviceready.html)` déclenché. + +## Plates-formes supportées + +* Android + +## Exemple court + + document.addEventListener("searchbutton", onSearchKeyDown, false); + + function onSearchKeyDown() { + // Handle the search button + } + + +## Exemple complet + + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" + "http://www.w3.org/TR/html4/strict.dtd";> + <html> + <head> + <title>Search Button Example</title> + + <script type="text/javascript" charset="utf-8" src="cordova.js"></script> + <script type="text/javascript" charset="utf-8"> + + // Wait for device API libraries to load + // + function onLoad() { + document.addEventListener("deviceready", onDeviceReady, false); + } + + // device APIs are available + // + function onDeviceReady() { + // Register the event listener + document.addEventListener("searchbutton", onSearchKeyDown, false); + } + + // Handle the search button + // + function onSearchKeyDown() { + } + + </script> + </head> + <body onload="onLoad()"> + </body> + </html> \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/5ad93d20/www/docs/fr/7.x/cordova/events/events.startcallbutton.md ---------------------------------------------------------------------- diff --git a/www/docs/fr/7.x/cordova/events/events.startcallbutton.md b/www/docs/fr/7.x/cordova/events/events.startcallbutton.md new file mode 100644 index 0000000..aa70f48 --- /dev/null +++ b/www/docs/fr/7.x/cordova/events/events.startcallbutton.md @@ -0,0 +1,82 @@ +--- +license: > + Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +title: startcallbutton +--- + +# startcallbutton + +L'évènement se déclenche lorsque l'utilisateur appuie sur la touche d'appel. + + document.addEventListener("startcallbutton", yourCallbackFunction, false); + + +## Détails + +Si vous souhaitez modifier le comportement par défaut de la touche d'appel, vous pouvez enregistrer un écouteur pour l'évènement `startcallbutton`. + +Les applications devraient en général utiliser `document.addEventListener` pour attacher un écouteur d'évènements, une fois l'évènement `[deviceready](events.deviceready.html)` déclenché. + +## Plates-formes supportées + +* BlackBerry 10 + +## Exemple court + + document.addEventListener("startcallbutton", onStartCallKeyDown, false); + + function onStartCallKeyDown() { + // Handle the start call button + } + + +## Exemple complet + + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" + "http://www.w3.org/TR/html4/strict.dtd";> + <html> + <head> + <title>Start Call Button Example</title> + + <script type="text/javascript" charset="utf-8" src="cordova.js"></script> + <script type="text/javascript" charset="utf-8"> + + // Wait for device API libraries to load + // + function onLoad() { + document.addEventListener("deviceready", onDeviceReady, false); + } + + // device APIs are available + // + function onDeviceReady() { + // Register the event listener + document.addEventListener("startcallbutton", onStartCallKeyDown, false); + } + + // Handle the start call button + // + function onStartCallKeyDown() { + } + + </script> + </head> + <body onload="onLoad()"> + </body> + </html> \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/5ad93d20/www/docs/fr/7.x/cordova/events/events.volumedownbutton.md ---------------------------------------------------------------------- diff --git a/www/docs/fr/7.x/cordova/events/events.volumedownbutton.md b/www/docs/fr/7.x/cordova/events/events.volumedownbutton.md new file mode 100644 index 0000000..101a7ec --- /dev/null +++ b/www/docs/fr/7.x/cordova/events/events.volumedownbutton.md @@ -0,0 +1,83 @@ +--- +license: > + Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +title: volumedownbutton +--- + +# volumedownbutton + +L'évènement se déclenche lorsque l'utilisateur clique sur le bouton diminution du volume. + + document.addEventListener("volumedownbutton", yourCallbackFunction, false); + + +## Détails + +Si vous souhaitez modifier le comportement par défaut du bouton diminution du volume, vous pouvez enregistrer un écouteur pour l'évènement `volumedownbutton`. + +Les applications devraient en général utiliser `document.addEventListener` pour attacher un écouteur d'évènements, une fois l'évènement `[deviceready](events.deviceready.html)` déclenché. + +## Plates-formes supportées + +* BlackBerry 10 +* Android + +## Exemple court + + document.addEventListener("volumedownbutton", onVolumeDownKeyDown, false); + + function onVolumeDownKeyDown() { + // Handle the volume down button + } + + +## Exemple complet + + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" + "http://www.w3.org/TR/html4/strict.dtd";> + <html> + <head> + <title>Volume Down Button Example</title> + + <script type="text/javascript" charset="utf-8" src="cordova.js"></script> + <script type="text/javascript" charset="utf-8"> + + // Wait for device API libraries to load + // + function onLoad() { + document.addEventListener("deviceready", onDeviceReady, false); + } + + // device APIs are available + // + function onDeviceReady() { + // Register the event listener + document.addEventListener("volumedownbutton", onVolumeDownKeyDown, false); + } + + // Handle the volume down button + // + function onVolumeDownKeyDown() { + } + + </script> + </head> + <body onload="onLoad()"> + </body> + </html> \ No newline at end of file --------------------------------------------------------------------- To unsubscribe, e-mail: commits-unsubscr...@cordova.apache.org For additional commands, e-mail: commits-h...@cordova.apache.org
