mozilla
Los resultados de tu búsqueda

    Crear microformatos en JavaScript

    Imagen:traduccion-pendiente.png Esta página está traduciéndose a partir del artículo Describing_microformats in JavaScript, razón por la cual puede haber algunos errores sintácticos o partes sin traducir. Puedes colaborar continuando con la traducción


    Los microformatos son descritos en JavaScript usando un formato de estructura estandarizada que tiene varios miembros estándar que describen el objeto.

    Formato de definición de microformatos

    La definición de microformatos debe contener las siguientes entradas:

    mfVersion
    Especifica el numero de versión del microformato API a la definición de la cual fue escrita. Para Firefox 3, este debe ser fijado a 0.8.
    mfObject
    El objeto JavaScript que implementa el microformato.
    className
    Una cadena especificando el nombre de las clase de microformato como es referenciada en HTML (class="className").
    required
    Un areglo indicando los nombres de todas las propiedades que deben ser especificadas. Este debe ser omitido si todas las propiedades son opcionales.
    properties
    Una estructura describiendo las propiedades del microformato.

    Especificaciones de las propiedades

    Cada propiedad en la estructura properties es especificada por su nombre, y debe incluir atributos adicionales si la propiedad lo requiere. Los atributos estándar son:

    plural
    Un valor booleano que, si  es true indica que la propiedad puede tener multiples valores. Si una propiedad es plural, este es retornado como un arreglo.
    virtual
    Un valor booleano que indica si la propiedad es virtual o no. Si esta es virtual, el metodo virtualGetter() sera llamado para intentar crear la propiedad si esta no existe.
    virtualGetter
    Una funcion que es creada para conseguir el valor de una propiedad virtual. Esta función es usada solo si virtual es true.
    value
    El valor por defecto de la propiedad.
    subproperties
    Es posible para una propiedad incluir en si misma mas propiedades; para hacer esto, se deben incluir en una estructura subproperties dentro de la propiedad.
    dataType
    El tipo de dato contenido por la propiedad. Los posibles valores son:
    dateTime
    Una fecha ISO
    anyURI
    Un URI
    email
    Una dirección de correo electrónico.
    tel
    Un numero de teléfono.
    HTML
    HTML incluyendo etiquetas.
    float
    Un numero de punto flotante.
    microformat
    Un microformato.
    microformat_property
    Una propiedad especifica dentro del microformato especificada por microformat.
    custom
    datos de aduana.

    Un ejemplo simple

    El microformato hCard para definir información de contactos hace uso del microformato adr para definir una dirección. el microformato adr es definido a continuación:

    var adr_definition = {
      mfVersion: 0.8,
      mfObject: adr,
      className: "adr",
      properties: {
        "type" : {
          plural: true,
          types: ["work", "home", "pref", "postal", "dom", "intl", "parcel"]
        },
        "post-office-box" : {
        },
        "street-address" : {
          plural: true
        },
        "extended-address" : {
        },
        "locality" : {
        },
        "region" : {
        },
        "postal-code" : {
        },
        "country-name" : {
        }
      }
    };
    

    Las propiedades aqui son absolutamente simples. La propiedad type indica el tipo de dirección representada por el objeto (trabajo, hogar, y asi sucesivamente). Desde que la propiedad plural sea true, multiples tipos pueden ser especificados. Esto permite a una dirección ser marcada como sea, por ejemplo, una dirección de trabajo para recibir paquetes.

    La propiedad street-address es tambien plural. Esto permite que multiples líneas de información sean contenidas en el arreglo street-address.

    El microformato esta registrado con el microformato API llamando Microformats.add(), como este:

    Microformats.add("adr", adr_definition);
    

    Nota:  Para ser claro: desde que el  microformato adr esta incluido por defecto en Firefox 3 y posteriores, usted no necesita agregarlo por si mismo si necesita usarlo.

    Ver tambien

    Using microformats, Parsing microformats in JavaScript

    Etiquetas y colaboradores del documento

    Contributors to this page: edwinduque@gmail.com, Mgjbot
    Última actualización por: edwinduque@gmail.com,